Skill Aligner
Key Files
- •
AGENTS.md— authoritative repo conventions and critical constraints - •
src/*/AGENTS.md— domain-specific rules (one per domain) - •
.agents/skills/*/SKILL.md— all skill definitions to scan - •
package.json— real commands and script names
Workflow
- •Read
AGENTS.mdand relevantsrc/*/AGENTS.mdfiles to capture authoritative conventions. - •Review
package.jsonscripts for real commands and required ordering (lint → test → build). - •Scan all
.agents/skills/*/SKILL.mdfiles for mismatched commands, paths, or terminology. - •Verify each skill has a "Key Files" section with actual project paths.
- •Verify each skill has a "Related Skills" section for cross-references.
- •Rewrite
SKILL.mdfiles to match repo language, paths, and constraints. - •Ensure descriptions clearly define when the skill should and should not trigger.
Output
- •Updated
SKILL.mdfiles with repo-aligned descriptions and steps. - •A short alignment report highlighting corrected mismatches.
Related Skills
- •
skilltest— validates skill structure and metadata after alignment - •
skill-qa-harness— runs prompt-case tests to verify skill content - •
repo-guardrails-generator— the guardrails that skills must align with