name: skill-advanced-patterns description: "Advanced skill development patterns. Keywords: skill, advanced, patterns."

Advanced Topics

This document captures advanced considerations for evolving the skill system.

Versioning

• Keep the SSOT contract versionable:
  • /.system/skills/ssot/**/<skill-name>/SKILL.md front matter fields (name, description)
  • scripts/devops/skills/sync_skills.py behavior and emitted wrapper format
• Prefer additive changes; treat renames/removals as breaking (skills are user-facing identifiers).

Dependencies and composition

Some skills naturally depend on others (e.g., backend patterns often depend on error tracking).

If dependencies are modeled:

• Keep them explicit and minimal
• Avoid deep dependency chains

Governance

• Skills should stay narrow and composable.
• Large topics should be split into resources, not monolith docs.
• Add alignment docs to clarify boundaries between overlapping skills/workflows.