opencode-skills-maintainer

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