1k-new-skill

To create a new Claude Code Skill, you need to scaffold a standard directory with SKILL.md at the root and at least one references/rules entry. This structure ensures consistent metadata, clear quick references, and safe activation for your workflow.

You should merge topics into an existing skill when the content aligns closely with current ontology, but split them into focused new skills when addressing distinct functionalities. The skill provides decision logic to help evaluate whether to merge or split topics.

Skill creation requires passing token usage checks and enforcing strict field requirements to ensure scalable, maintainable skills. These validation steps and safety guidelines prevent bloated metadata and ensure high-quality, safe activation.

Setting up a maintainable skill ontology requires standardizing a new skill directory with SKILL.md, a references/rules/ folder, and optional scripts/references/assets. This standardized structure organizes metadata and enforces strict field requirements.

Yes, building a Claude Code Skill involves fetching the latest documentation to ensure accurate metadata and best practices. The workflow outlines how to retrieve current docs before assembling SKILL.md and rule files.

Yes, you can use it to optimize skill ontology by applying decision logic to merge or split topics, validating strict field requirements, and running token-optimization checks. This ensures your existing skills remain maintainable and scalable.