fix(skills): rename index.md to SKILL.md for Claude Code skill discovery

Claude Code discovers skills by looking for SKILL.md (not index.md) in
skill directories. All 16 skill templates were invisible to Claude Code's
auto-discovery because they used the wrong filename. This also updates
all agent, workflow, convention, and test references.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: maystudios

INTERNALS.md

@@ -428,7 +428,7 @@ directly — it is copied into `dist/assets/templates/` during the build.
 
 ### Skills (15)
 
-Located at `templates/skills/`, one subdirectory per skill with an `index.md`.
+Located at `templates/skills/`, one subdirectory per skill with a `SKILL.md`.
 All follow Anthropic's skill convention: YAML frontmatter with `name` and
 `description`, body under 500 lines, no `@` imports.
 

README.md

@@ -349,7 +349,7 @@ Project config lives in `.claude/maxsim/config.json`, created during `/maxsim:in
 
 ## Skills
 
-Skills are reusable prompt modules that agents load on demand. Each skill is an `index.md` file with YAML frontmatter and a markdown body.
+Skills are reusable prompt modules that agents load on demand. Each skill is a `SKILL.md` file with YAML frontmatter and a markdown body.
 
 ### Built-in Skills (15)
 

packages/cli/README.md

@@ -349,7 +349,7 @@ Project config lives in `.claude/maxsim/config.json`, created during `/maxsim:in
 
 ## Skills
 
-Skills are reusable prompt modules that agents load on demand. Each skill is an `index.md` file with YAML frontmatter and a markdown body.
+Skills are reusable prompt modules that agents load on demand. Each skill is a `SKILL.md` file with YAML frontmatter and a markdown body.
 
 ### Built-in Skills (15)
 

packages/cli/tests/unit/templates.test.ts

@@ -73,19 +73,19 @@ describe('skill templates', () => {
     expect(skillDirs).toHaveLength(16);
   });
 
-  it('each subdirectory contains an index.md file', () => {
+  it('each subdirectory contains a SKILL.md file', () => {
     for (const dir of skillDirs) {
-      const skillMd = path.join(skillsDir, dir.name, 'index.md');
-      expect(fs.existsSync(skillMd), `${dir.name}: missing index.md`).toBe(true);
+      const skillMd = path.join(skillsDir, dir.name, 'SKILL.md');
+      expect(fs.existsSync(skillMd), `${dir.name}: missing SKILL.md`).toBe(true);
     }
   });
 
-  it('each index.md has frontmatter with name and description', () => {
+  it('each SKILL.md has frontmatter with name and description', () => {
     for (const dir of skillDirs) {
-      const content = fs.readFileSync(path.join(skillsDir, dir.name, 'index.md'), 'utf-8');
+      const content = fs.readFileSync(path.join(skillsDir, dir.name, 'SKILL.md'), 'utf-8');
       const { attributes } = parseFrontmatter(content);
-      expect(attributes.name, `${dir.name}/index.md: missing name`).toBeDefined();
-      expect(attributes.description, `${dir.name}/index.md: missing description`).toBeDefined();
+      expect(attributes.name, `${dir.name}/SKILL.md: missing name`).toBeDefined();
+      expect(attributes.description, `${dir.name}/SKILL.md: missing description`).toBeDefined();
     }
   });
 });

templates/agents/executor.md

@@ -15,10 +15,10 @@ skills:
   - commit-conventions
 available_skills:
   - name: github-operations
-    path: .claude/skills/github-operations/index.md
+    path: .claude/skills/github-operations/SKILL.md
     trigger: When reading from or writing to GitHub Issues
   - name: tdd
-    path: .claude/skills/tdd/index.md
+    path: .claude/skills/tdd/SKILL.md
     trigger: When implementing features with test-first approach
 ---
 

templates/agents/planner.md

@@ -14,10 +14,10 @@ skills:
   - roadmap-writing
 available_skills:
   - name: github-operations
-    path: .claude/skills/github-operations/index.md
+    path: .claude/skills/github-operations/SKILL.md
     trigger: When reading phase context from GitHub Issues
   - name: brainstorming
-    path: .claude/skills/brainstorming/index.md
+    path: .claude/skills/brainstorming/SKILL.md
     trigger: When exploring multiple implementation approaches
 ---
 

templates/agents/researcher.md

@@ -14,7 +14,7 @@ skills:
   - research
 available_skills:
   - name: github-operations
-    path: .claude/skills/github-operations/index.md
+    path: .claude/skills/github-operations/SKILL.md
     trigger: When reading context from GitHub Issues
 ---
 

templates/agents/verifier.md

@@ -13,10 +13,10 @@ skills:
   - code-review
 available_skills:
   - name: systematic-debugging
-    path: .claude/skills/systematic-debugging/index.md
+    path: .claude/skills/systematic-debugging/SKILL.md
     trigger: When investigating test failures or unexpected behavior
   - name: github-operations
-    path: .claude/skills/github-operations/index.md
+    path: .claude/skills/github-operations/SKILL.md
     trigger: When posting verification results to GitHub
 ---
 

templates/rules/conventions.md

@@ -29,7 +29,7 @@ Co-author line when AI-assisted: value comes from the `co_author` key in `.claud
 
 | Type | Path Pattern |
 |------|-------------|
-| Skills | `.claude/skills/<kebab-case>/index.md` |
+| Skills | `.claude/skills/<kebab-case>/SKILL.md` |
 | Agents | `.claude/agents/<simple-name>.md` |
 | Rules | `.claude/rules/<topic>.md` |
 | Plans | GitHub Sub-Issues on the phase Issue |