mr-onion

Phase 21 — Make the Skills Actually Discoverable

Version: 1.0 Date: 2026-09-16 Status: Shipped as TFP-051 — skills/.claude-plugin/plugin.json + a local marketplace + a committed .claude/settings.json make every skill under skills/testing/ and skills/engineering/ a real, auto-discovered Claude Code plugin skill, confirmed present on disk and described as fixed in skills/ROADMAP.md’s own Known-gaps section. This doc’s header was never updated when it landed. Corrected 2026-09-23 (Cowork verification pass).

Context

skills/ROADMAP.md’s “Known gaps” section has flagged this since Phase 17 and it was never picked up: write-playwright-test (and now the other ten) live under a bare top-level skills/ directory, which Claude Code’s own skill-discovery mechanism does not scan. Every skill built across Phases 17-20 is real, tested content — but none of it is actually invocable as a Claude Code skill today. Right now “running a skill” in this repo has meant a person or an agent manually opening the SKILL.md file and following it, which works but isn’t what any of this was built for.

This matters concretely for Phase 19: TFP-041 asks Claude Code to run write-playwright-test directly against test-assist “with no TestForge app involved — skill judgment in isolation.” If that only means “read the file and follow it,” the exercise doesn’t actually test whether the skill works the way REIMAGINING.md originally proposed using it — invoked, not read.

Findings, checked directly before drafting this (Claude Code’s own documentation, not assumed):

Scope (this phase)

In scope

  1. Make every skill under skills/testing/ and skills/engineering/ actually discoverable and invocable by Claude Code, without duplicating or moving the canonical files (the testing/engineering split stays; it was a deliberate Phase 18 decision).
  2. Verify discovery for real — invoke at least one skill from each category via Claude Code’s actual skill mechanism, not by manually reading the file.

Out of scope

Backlog

TFP-051 - Package skills/ as a discoverable Claude Code plugin

TFP-051 can run in parallel with TFP-040 (running the app doesn’t depend on skill discovery), but must finish before TFP-041 (which specifically needs real invocation, not a manual read) starts.

Suggested Milestone Gates

Gate A - Skills are real Claude Code skills, not just files