refactor(skills): move maintainer-only skills to .claude/skills/ (#439)

* ci: update install stats

* ci: update install stats

* refactor(skills): move maintainer skills under .claude/skills/

6 dev-only skill dirs (context-mode-ops, diagnose, grill-me,
grill-with-docs, improve-codebase-architecture, tdd) were under
skills/ which the plugin manifest exposes to all users. Every Claude
Code session loaded ~410 tokens/turn of descriptions for workflows
only the maintainer invokes (GH triage/release, debug loops, TDD,
architecture refactor, plan-grilling).

Moving them to .claude/skills/ means Claude Code auto-loads them for
the maintainer via project-scoped discovery while keeping them out of
the published plugin manifest. End users save ~410 tokens/turn.

Remove the now-stale skills/context-mode-ops/ line from .npmignore;
the path no longer exists and .claude/ is not packaged regardless.

Update skills/UPSTREAM-CREDITS.md: fix local paths in the inventory
table (skills/* -> .claude/skills/*) and fix the update script's
cp target path. Add a paragraph explaining why these skills live
under .claude/skills/ rather than skills/.

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
This commit is contained in:
Juyeob Maeng
2026-05-09 03:42:48 +09:00
committed by GitHub
parent 84b8d15c0f
commit 138f22fe3d
27 changed files with 15 additions and 9 deletions
-1
View File
@@ -10,7 +10,6 @@ tsconfig.json
bun.lock
BENCHMARK.md
PRD*.md
skills/context-mode-ops/
tasks/
.github/
.DS_Store
+15 -8
View File
@@ -2,8 +2,15 @@
context-mode vendors a small set of operating-discipline skills authored
by Matt Pocock. They are referenced as the operational backbone of the
[`context-mode-ops`](context-mode-ops/SKILL.md) skill (`/diagnose`, `/tdd`,
`/grill-me`, `/grill-with-docs`, `/improve-codebase-architecture`).
[`context-mode-ops`](../.claude/skills/context-mode-ops/SKILL.md) skill
(`/diagnose`, `/tdd`, `/grill-me`, `/grill-with-docs`,
`/improve-codebase-architecture`).
These skills live under `.claude/skills/` rather than `skills/` because
`context-mode-ops` is a maintainer-only workflow; shipping them to every
plugin install would pay description tokens for tools end users never
invoke. Maintainers working inside this repo still get them auto-loaded
via Claude Code's project-scoped skill discovery.
## Source
@@ -15,11 +22,11 @@ by Matt Pocock. They are referenced as the operational backbone of the
| Skill | Upstream path | Local path |
|-------|---------------|------------|
| `/diagnose` | `skills/engineering/diagnose/` | `skills/diagnose/` |
| `/tdd` | `skills/engineering/tdd/` | `skills/tdd/` |
| `/grill-me` | `skills/productivity/grill-me/` | `skills/grill-me/` |
| `/grill-with-docs` | `skills/engineering/grill-with-docs/` | `skills/grill-with-docs/` |
| `/improve-codebase-architecture` | `skills/engineering/improve-codebase-architecture/` | `skills/improve-codebase-architecture/` |
| `/diagnose` | `skills/engineering/diagnose/` | `.claude/skills/diagnose/` |
| `/tdd` | `skills/engineering/tdd/` | `.claude/skills/tdd/` |
| `/grill-me` | `skills/productivity/grill-me/` | `.claude/skills/grill-me/` |
| `/grill-with-docs` | `skills/engineering/grill-with-docs/` | `.claude/skills/grill-with-docs/` |
| `/improve-codebase-architecture` | `skills/engineering/improve-codebase-architecture/` | `.claude/skills/improve-codebase-architecture/` |
## Why vendor instead of just listing as docs?
@@ -38,7 +45,7 @@ To pull upstream changes:
git clone --depth 1 https://github.com/mattpocock/skills /tmp/mattpocock-skills-update
for d in diagnose tdd grill-me grill-with-docs improve-codebase-architecture; do
src=$(find /tmp/mattpocock-skills-update/skills -maxdepth 3 -type d -name "$d" | head -1)
cp -R "$src/." "skills/$d/"
cp -R "$src/." ".claude/skills/$d/"
done
# Then update the commit SHA above and run the full test suite.
```