1.8 KiB
Skills
Skills are reusable workflows. Rules are persistent constraints and agents are specialized roles. Each skill is a minimal SKILL.md with YAML frontmatter and a small initial workflow so both clients can consume it.
The current structure is organized by purpose:
debugging/planning/: implementation planning, impact analysis, and work-item definitionresearch/: technical and repository researchreviews/: code, security, performance, WPF, UI/UX, business, API, and EF Core reviewsimplementation/: SQL, unit-test, and integration-test writingverification/: facts, work-item, and regression verificationgit/: pull request reviews
Each skill defines a focused workflow with the investigation, decision points, and output expected for that task. Keep guidance specific to the skill; shared repository constraints belong in the rules.
Claude's generated package additionally has skills/rules/: one skill per focused rule file or directory in
shared/rules/. The rule-to-skill loading conditions live in shared/global-instructions.md, so full rule text loads
only when Claude invokes a matching skill instead of sitting permanently in context. Codex reads the matching rule
files directly. Both clients embed the general rules in their global instructions.
Language, framework, library, and security rules use directory indexes plus focused topic files. Their generated Claude skills expose each focused rule separately; the index skills also include the references for contextual lookup. See Configuration.
Skills guide a task when needed; their availability does not require a full review, build, or test suite after every change. The shared Verification rules govern proportional checking, including when generic skill workflows call for more work than the change needs.