From 38efd2be67f6dd4cd0361c2570d0bce521fd4c60 Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Sun, 30 Aug 2026 17:45:50 +0000 Subject: [PATCH] fix(skills): collapse verb-enumerated descriptions to one capability clause MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit An independent audit of the ADR-0020 retrofit (issue #99) found that git-submodules, git-worktrees, and gitea-files each collapsed their description length correctly during retrofit but left the capability clause as a verb enumeration (e.g. "Create, list, lock, move, remove, prune, or repair") instead of ADR-0020's required single clause. The deterministic char-count gate can't catch this — it's a qualitative rubric violation the retrofit commits' own messages never claimed to address, only measurable length/word-count fixes. Validated clean via skill-audit and skill-size-check after the fix; boundary clauses and routing targets left untouched. Refs #99 --- plugins/git/.apm/skills/git-submodules/SKILL.md | 4 ++-- plugins/git/.apm/skills/git-worktrees/SKILL.md | 4 ++-- plugins/git/skills/git-submodules/SKILL.md | 4 ++-- plugins/git/skills/git-worktrees/SKILL.md | 4 ++-- plugins/gitea/.apm/skills/gitea-files/SKILL.md | 6 +++--- plugins/gitea/skills/gitea-files/SKILL.md | 6 +++--- 6 files changed, 14 insertions(+), 14 deletions(-) diff --git a/plugins/git/.apm/skills/git-submodules/SKILL.md b/plugins/git/.apm/skills/git-submodules/SKILL.md index 1fc6d8d..60b86b4 100644 --- a/plugins/git/.apm/skills/git-submodules/SKILL.md +++ b/plugins/git/.apm/skills/git-submodules/SKILL.md @@ -2,8 +2,8 @@ name: git-submodules description: > - Use when managing Git submodules — adding, updating, pinning, inspecting, - repointing, or removing a nested repository inside a superproject. + Use when managing Git submodules — the full lifecycle of a nested + repository inside a superproject. Not multiple checkouts of one repo -> `git-worktrees`. Not the superproject's own remotes -> `git-remotes`. diff --git a/plugins/git/.apm/skills/git-worktrees/SKILL.md b/plugins/git/.apm/skills/git-worktrees/SKILL.md index 51a1980..2a74445 100644 --- a/plugins/git/.apm/skills/git-worktrees/SKILL.md +++ b/plugins/git/.apm/skills/git-worktrees/SKILL.md @@ -2,8 +2,8 @@ name: git-worktrees description: > - Use when working on several branches at once without stashing. - Create, list, lock, move, remove, prune, or repair git worktrees. + Use when working on several branches at once without stashing — + manages the full lifecycle of a git worktree. Not ordinary branch switching or checkout -> `git-branches`. Not interactive multi-step git guidance -> `git-workflow`. diff --git a/plugins/git/skills/git-submodules/SKILL.md b/plugins/git/skills/git-submodules/SKILL.md index 1fc6d8d..60b86b4 100644 --- a/plugins/git/skills/git-submodules/SKILL.md +++ b/plugins/git/skills/git-submodules/SKILL.md @@ -2,8 +2,8 @@ name: git-submodules description: > - Use when managing Git submodules — adding, updating, pinning, inspecting, - repointing, or removing a nested repository inside a superproject. + Use when managing Git submodules — the full lifecycle of a nested + repository inside a superproject. Not multiple checkouts of one repo -> `git-worktrees`. Not the superproject's own remotes -> `git-remotes`. diff --git a/plugins/git/skills/git-worktrees/SKILL.md b/plugins/git/skills/git-worktrees/SKILL.md index 51a1980..2a74445 100644 --- a/plugins/git/skills/git-worktrees/SKILL.md +++ b/plugins/git/skills/git-worktrees/SKILL.md @@ -2,8 +2,8 @@ name: git-worktrees description: > - Use when working on several branches at once without stashing. - Create, list, lock, move, remove, prune, or repair git worktrees. + Use when working on several branches at once without stashing — + manages the full lifecycle of a git worktree. Not ordinary branch switching or checkout -> `git-branches`. Not interactive multi-step git guidance -> `git-workflow`. diff --git a/plugins/gitea/.apm/skills/gitea-files/SKILL.md b/plugins/gitea/.apm/skills/gitea-files/SKILL.md index 18e47cb..ace6379 100644 --- a/plugins/gitea/.apm/skills/gitea-files/SKILL.md +++ b/plugins/gitea/.apm/skills/gitea-files/SKILL.md @@ -2,9 +2,9 @@ name: gitea-files description: > - Use when reading or writing files in a Gitea repository rather than on the local filesystem — - read, list, walk the tree, create, update, or delete — even when the user does not say "Gitea". - Not commit history -> `gitea-branches`. Not pull requests -> `gitea-prs`. + Use when reading or writing files or directories in a Gitea repository via the MCP server, + rather than the local filesystem — even when the user does not say "Gitea". Not commit + history -> `gitea-branches`. Not pull requests -> `gitea-prs`. compatibility: Requires the Gitea MCP server configured with a token scoped to at least write:repository. Tested with a token holding write:issue + write:repository; write:issue diff --git a/plugins/gitea/skills/gitea-files/SKILL.md b/plugins/gitea/skills/gitea-files/SKILL.md index 18e47cb..ace6379 100644 --- a/plugins/gitea/skills/gitea-files/SKILL.md +++ b/plugins/gitea/skills/gitea-files/SKILL.md @@ -2,9 +2,9 @@ name: gitea-files description: > - Use when reading or writing files in a Gitea repository rather than on the local filesystem — - read, list, walk the tree, create, update, or delete — even when the user does not say "Gitea". - Not commit history -> `gitea-branches`. Not pull requests -> `gitea-prs`. + Use when reading or writing files or directories in a Gitea repository via the MCP server, + rather than the local filesystem — even when the user does not say "Gitea". Not commit + history -> `gitea-branches`. Not pull requests -> `gitea-prs`. compatibility: Requires the Gitea MCP server configured with a token scoped to at least write:repository. Tested with a token holding write:issue + write:repository; write:issue