What problem does it solve?
Automatically keep Build-With-Skills and Plan-With-Skills prompts in sync with the latest skills by scanning the skills/ folder for SKILL.md files, extracting metadata, and updating agent system prompts.
Core Features & Use Cases
- Discover All Skills: Scan the skills/ folder to enumerate every SKILL.md
- Extract Skill Metadata: Read frontmatter to capture name, description, and category
- Categorize Skills: Organize skills into logical categories for prompts
- Update Agent Prompts: Refresh both Build-With-Skills and Plan-With-Skills prompts with the current skill list
- Validate Changes: Ensure config.json remains valid after updates
- Generate Report: Produce a summary of changes
Quick Start
Discover the skills, extract metadata, and update prompts with a simple workflow:
- Discover all skills: find skills/ -name SKILL.md -type f | sort
- Extract metadata: for skill_dir in skills/*/; do echo "=== $(basename "$skill_dir") ==="; head -10 "$skill_dir/SKILL.md" | grep -E "(name:|description:)" | head -2; done
- Update prompts: opencode --agent build-with-skills "Use opencode-skills-maintainer to update agent prompts"; opencode --agent plan-with-skills "Use opencode-skills-maintainer to update agent prompts"
- Validate: jq . config.json