ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(skills): add SKILL-MIGRATION-GUIDE + adopt root-SKILL.md hybrid as standard

Browse Source 
- reference/SKILL-MIGRATION-GUIDE.md: one-page recipe to add a root SKILL.md to an
  existing skill (additive, no rewrite) — target structure, frontmatter checklist,
  a verified validation snippet, incremental-adoption guidance. References 16/17.
- CLAUDE.md: replace "Dual-Platform Skill Structure" with the hybrid (root SKILL.md +
  code/ + desktop/) as the going-forward standard; add "Root SKILL.md first" design
  principle; require a root SKILL.md for new skills; link the guide in Key Reference Files.
- SKILL-FORMAT-REQUIREMENTS.md: note the root-SKILL.md standard + cross-link the guide.

Validation snippet self-tested against 16/17 (frontmatter ≤1024, kebab name, all
referenced relative paths resolve).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Andrew Yim
2026-05-28 00:50:50 +09:00
parent 1e3b2a4fa0
commit 01201ee4a2
3 changed files with 133 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
reference/SKILL-FORMAT-REQUIREMENTS.md
View File

@@ -1,5 +1,10 @@
# Claude Skills - Format Requirements
> **Going-forward standard:** each skill also gets a **root `SKILL.md`** (official Agent
> Skills format, natively loadable) alongside the `code/` + `desktop/` packaging described
> below. To add one to an existing skill, see `SKILL-MIGRATION-GUIDE.md`. This document
> remains the spec for the dual-platform packaging layers.
## Overview
This document describes the format requirements for Claude Skills in this repository. Skills support dual-platform development (Claude Code and Claude Desktop) with separated concerns.