opencode-skills-maintainer

Scan skills/ for SKILL.md files and update agent prompts.

4|4|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/darellchua2/opencode-config-template --skill opencode-skills-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opencode-skills-maintainer
Source: https://github.com/darellchua2/opencode-config-template/tree/main/skills/opencode-skills-maintainer
Command: npx skills add https://github.com/darellchua2/opencode-config-template --skill opencode-skills-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

Frequently Asked Questions about opencode-skills-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate syncing agent prompts with newly added skills?

To automate syncing agent prompts, scan the skills/ directory for SKILL.md files to extract metadata and refresh Build-With-Skills and Plan-With-Skills prompts. This ensures your agent prompts reflect current capabilities without manual updates.

What is the best way to maintain OpenCode skills metadata across multiple agents?

The best way to maintain skills metadata is to automate discovery by scanning the skills/ folder for SKILL.md files, categorizing the extracted frontmatter, and updating agent system prompts to keep everything in sync.

How does skills discovery work when updating agent prompts?

Skills discovery works by scanning the skills/ directory for SKILL.md files, extracting frontmatter like name and description, and organizing them into logical categories to refresh agent prompts.

Do I need to manually edit config.json after updating agent prompts?

No, you do not need to manually edit config.json. The maintenance process validates changes against config.json automatically and reports a summary of updates to ensure it remains valid.

Can I use this skill to extract metadata from SKILL.md frontmatter?

Yes, you can use this skill to extract metadata from SKILL.md frontmatter. It reads the files to capture the name, description, and category of each skill for organizing into prompts.

What happens if config.json validation fails after a prompt update?

If config.json validation fails after a prompt update, the process validates changes against config.json and reports a summary of updates, allowing you to identify and correct any structural inconsistencies.