Skills Index Updater

Skill index updater

Automatically regenerate skill indexes by scanning skill directories and updating:

• Global skills → ~/.kiro/steering/global.md (always updated)
• Local skills → AGENTS.md in the repo (only when NOT in home directory)

⚠️ STOP: Check before running

This skill is ONLY for IDEs without native skill support (Kiro, Gemini, Cursor, etc.).

Claude Code users: You do NOT need this - Claude Code has native skill indexing built-in.

Only run if the user explicitly asked to update skill indexes for compatibility with other tools.

Quick start

# Run from any location
python3 ~/.claude/skills/skills-index-updater/scripts/update_skill_index.py

# Preview changes without writing
python3 ~/.claude/skills/skills-index-updater/scripts/update_skill_index.py --dry-run

Prerequisites

• Python 3.8+
• PyYAML package (pip install pyyaml) - optional, falls back to regex parsing
• ~/.kiro/steering/global.md must exist with ## Available Skills Index section

How it works

The script automatically determines what to update based on your current location:

Skill locations

Available flags

Workflow

1. Run the update script

python3 ~/.claude/skills/skills-index-updater/scripts/update_skill_index.py

The script will:

1. Detect your working directory and whether you're in a git repo
2. Scan global skills in ~/.claude/skills/
3. Update ~/.kiro/steering/global.md with global skills index
4. If in a repo (and not in home directory):
   • Scan local skills in .claude/skills/
   • Update AGENTS.md with local skills index

2. Verify output

# Check global.md update
grep -A 20 "## Available Skills Index" ~/.kiro/steering/global.md

# Check AGENTS.md update (if in a repo)
grep -A 10 "## Available Skills Index" AGENTS.md

Example output

Working directory: /Users/you/projects/my-repo
Home directory: /Users/you
In home directory: False
Repository root: /Users/you/projects/my-repo

============================================================
GLOBAL SKILLS
============================================================
Scanning global skills in: /Users/you/.claude/skills
  Found 5 global skills

  Skills found:
    - skill-builder (skill-builder)
    - skills-index-updater (skills-index-updater)
    - save-context (save-context)
    - humanize (humanize)
    - docx (docx)

Updated: /Users/you/.kiro/steering/global.md

============================================================
LOCAL SKILLS
============================================================
Scanning local skills in: /Users/you/projects/my-repo/.claude/skills
  Found 2 local skills

  Skills found:
    - extract-videos (extract-videos)
    - download-transcripts (download-transcripts)

Updated: /Users/you/projects/my-repo/AGENTS.md

============================================================
SUMMARY
============================================================
Index update complete.

Output formats

Global skills (in global.md)

## Available Skills Index
*(Auto-generated - do not edit manually)*

  path: .claude/skills/skill-builder
  name: skill-builder
  description: Create, evaluate, and improve Agent skills...
---
  path: .claude/skills/humanize
  name: humanize
  description: Convert AI-written text to more human-like writing...
---

Local skills (in AGENTS.md)

## Available Skills Index
_This index is for IDEs that don't natively support skills (e.g., Gemini CLI, Kiro). Skip if your IDE reads SKILL.md directly._

- **Name:** `extract-videos`
  - **Trigger:** Extract video URLs from various sources...
  - **Path:** `.claude/skills/extract-videos/SKILL.md`

- **Name:** `download-transcripts`
  - **Trigger:** Download and process video transcripts...
  - **Path:** `.claude/skills/download-transcripts/SKILL.md`

Quality rules

• Descriptions come from frontmatter - Never manually edit the index
• Global and local are separate - Each goes to its own file
• Run after every skill change - Create, delete, or modify triggers update

Troubleshooting

Additional resources

• TESTING.md - Evaluation scenarios and validation commands