Skill Developer

This skill is a meta-skill for maintaining the template鈥檚 skills/workflows library and the Skill Discovery tooling that generates provider wrappers.

Purpose

• •Create and evolve skill packages as SSOT under /.system/skills/ssot/**.
• •Keep skill entrypoints small and push deeper guidance into supporting docs.
• •Keep provider wrappers deterministic and in sync via sync_skills.py.

When to Use

Use this skill when:

• •Adding a new skill package under /.system/skills/ssot/**
• •Refactoring skill boundaries, triggers, or supporting files
• •Troubleshooting why a skill is not being discovered (description/keywords)
• •Updating wrapper generation or CI checks

System overview (template)

SSOT skill packages

• •SSOT lives under: /.system/skills/ssot/**/<skill-name>/SKILL.md
• •Each SSOT SKILL.md MUST include front matter:
  • •name (must match directory name)
  • •description (single-line; drives discovery)

Provider wrappers (generated)

• •Codex wrappers: /.codex/skills/<skill-name>/SKILL.md
• •Claude wrappers: /.claude/skills/<skill-name>/SKILL.md

Wrappers are generated by:

python scripts/devops/skills/sync_skills.py --regenerate --target repo --publish-set repo_minimal
python scripts/devops/skills/sync_skills.py --regenerate --target integration --publish-set integration_default

Validated by:

python scripts/devops/skills/sync_skills.py --check --target repo --publish-set repo_minimal
python scripts/devops/skills/sync_skills.py --check --target integration --publish-set integration_default

Creating a new skill (workflow)

1. •Choose a stable skill-name (kebab-case, <= 64 chars) and a grouping directory (optional).
2. •Create /.system/skills/ssot/<group>/<skill-name>/SKILL.md with:
   • •name: <skill-name>
   • •a strong description that includes trigger keywords and 鈥渨hen to use鈥?3. Add supporting files (optional) under the same directory (e.g. supporting files, examples/, scripts/).
3. •Regenerate + validate wrappers:
   • •python scripts/devops/skills/sync_skills.py --regenerate --target repo --publish-set repo_minimal
   • •python scripts/devops/skills/sync_skills.py --check --target repo --publish-set repo_minimal
   • •python scripts/devops/skills/sync_skills.py --regenerate --target integration --publish-set integration_default
   • •python scripts/devops/skills/sync_skills.py --check --target integration --publish-set integration_default

Resources (deep dives)

• •Trigger types: /.system/skills/ssot/repo/skill-developer/trigger-types/SKILL.md
• •Hook consumption patterns: /.system/skills/ssot/repo/skill-developer/skill-hook-mechanisms/SKILL.md
• •Pattern library: /.system/skills/ssot/repo/skill-developer/skill-patterns-library/SKILL.md
• •Troubleshooting: /.system/skills/ssot/repo/skill-developer/skill-troubleshooting/SKILL.md
• •Advanced topics: /.system/skills/ssot/repo/skill-developer/skill-advanced-patterns/SKILL.md