Commit graph

2 commits

Author SHA1 Message Date
Claude
1b152ab675
fix(v2.6.2): fix remaining 11 placeholder descriptions
Continues the v2.6.1 cleanup (PR #647). Fixes the final 11 placeholder
descriptions identified in the audit — skills whose description field was
literally just the skill name from a v2.0.0 batch import.

Skills fixed across 4 domains:

c-level-advisor (executive-mentor):
- executive-mentor/skills/challenge — pre-mortem plan analysis ("imagine
  it's 12 months from now and this plan failed")
- executive-mentor/skills/board-prep — adversarial board meeting prep

engineering (POWERFUL tier):
- git-worktree-manager — parallel feature work with Git worktrees
- skill-tester — meta-skill QA (structure + script + quality scoring)
- monorepo-navigator — Turborepo / Nx / pnpm / Lerna navigation
- env-secrets-manager — env-var hygiene + secrets rotation
- agent-workflow-designer — production-grade multi-agent workflows

engineering-team:
- incident-commander — incident response framework (detection → resolution)
- email-template-builder — React Email + provider integration (Resend,
  Postmark, SendGrid, AWS SES)
- stripe-integration-expert — subscriptions, webhooks, billing patterns

business-growth:
- contract-and-proposal-writer — jurisdiction-aware business documents
  (US/EU/UK/DACH; contracts, SOWs, NDAs, MSAs)

Each new description: ≤1024 chars, third person, action verb in first
sentence, "Use when ..." trigger in second sentence per Matt Pocock's rule.

All 11 descriptions PASS or WARN on skill_description_validator.py:
- 6 PASS: git-worktree-manager, skill-tester, monorepo-navigator,
  env-secrets-manager, incident-commander, email-template-builder
- 5 WARN: challenge, board-prep, agent-workflow-designer,
  stripe-integration-expert, contract-and-proposal-writer (warnings
  from other rules — SKILL.md > 100 lines, terminology drift — not
  the description itself)

Cumulative impact across v2.6.0 → v2.6.1 → v2.6.2:
- PASS:           4 (1%) → 7 (2%) → 9 (3%)        [+5]
- WARN:         111      → 134     → 137           [+26]
- FAIL:         183      → 157     → 152           [-31]
- Missing-trigger: 119   → 79      → 68            [-51]

31 skills total lifted from FAIL → WARN/PASS across v2.6.1 + v2.6.2.

Audit baseline preserved at 298 real skills (excludes auto-generated
.gemini/.codex/.cursor/.cline bundles and template fixtures).

Next cleanup target (v2.6.3 candidate): the 27% terminology-consistency
drift (agent/bot, skill/tool mixing) — bigger scope, requires careful
prose edits per file.

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-14 05:08:23 +00:00
Reza Rezvani
1851c8fb09 fix(plugins): restructure 9 multi-skill domain plugins into ./skills/ layout
Same root cause as #587/#591 — Claude Code's runtime loader rejects
array-form skills paths like ["./content-production", "./ai-seo", ...]
even when each entry is a valid subdirectory containing SKILL.md.
`claude plugin validate` accepts them but the loader does not.

The proven canonical layout (used by self-improving-agent in #536):

  <plugin>/
  ├── .claude-plugin/plugin.json    skills: "./skills"
  └── skills/
      ├── <skill-1>/SKILL.md
      ├── <skill-2>/SKILL.md
      └── ...

Restructured 9 multi-skill domain plugins:
- business-growth (4 skills moved)
- c-level-advisor (28)
- engineering (36)
- engineering-team (32)
- finance (2)
- marketing-skill (43)
- product-team (12)
- project-management (8)
- ra-qm-team (13)

Also fixed standalone plugins that had root SKILL.md + ./skills/ subdir
(agenthub, autoresearch-agent, executive-mentor, playwright-pro). The
loader rejected them despite skills="./skills" because of the conflicting
root SKILL.md (compare self-improving-agent which works because PR #536
moved its root SKILL.md). Moved each root SKILL.md into ./skills/<name>/.

Restored standalone plugin folders to their original paths after the
multi-skill restructure swept them into parent skills/ directories
(marketplace.json source paths require original locations).

Removed 7 orphaned marketplace entries that pointed to skill folders
without their own plugin.json (content-creator, demand-gen,
fullstack-engineer, aws-architect, product-manager, scrum-master,
skill-security-auditor) — these were already non-functional.

Bumped patch versions on every changed plugin and synced
marketplace.json. Marketplace now lists 29 working plugins (down
from 36).

After merge: users run `/plugin marketplace update claude-code-skills`
followed by `/plugin update --all` to pick up the working layout.
2026-05-02 22:51:20 +02:00