add-skill

Create and validate SKILL.md frontmatter and structure for agent skills.

190|14|Updated May 20, 2014

Search Tags:#templates #Claude #skill-management #SKILL.md #frontmatter #OpenCode

Ready to run

npx skills add https://github.com/elithrar/dotfiles --skill add-skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: add-skill
Source: https://github.com/elithrar/dotfiles/tree/main/.config/opencode/skill/add-skill
Command: npx skills add https://github.com/elithrar/dotfiles --skill add-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a standardized approach to creating or refining agent skills by enforcing a consistent SKILL.md frontmatter, structure, and guidance for OpenCode or Claude integrations.

Core Features & Use Cases

Enforces required frontmatter: name and description
Guides file organization: SKILL.md at root with optional references/
Provides templates for descriptive content and Quick Start
Supports structured content for OpenCode/Claude skill loading

Quick Start

Create or update SKILL.md with a frontmatter block like:

name: my-skill description: A concise description of the skill.

Then add optional references/ for detailed content if needed.

Frequently Asked Questions about add-skill

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

FAQPage Schema

How do I create a standardized skill with frontmatter and structure?▼

Create a SKILL.md file at your project root with a frontmatter block containing name and description fields, then add your skill content below. This standardized structure ensures your OpenCode or Claude skill loads correctly and maintains consistency across agent integrations.

What's required in a SKILL.md frontmatter?▼

SKILL.md frontmatter requires two fields: name (your skill identifier) and description (a concise explanation of what it does). These enforced fields ensure your skill metadata is complete and machine-readable for agent systems.

Can I organize skill documentation with additional files?▼

Yes, create an optional references/ directory alongside SKILL.md to store extended content and detailed documentation. This separation keeps your skill root clean while supporting richer reference material for users.

How do I validate that my skill follows the required structure?▼

The skill enforces frontmatter and file organization rules through plain Markdown guidelines. Ensure SKILL.md exists at your project root with valid frontmatter (name and description) and optional references/ subdirectory, then use the provided templates to structure your content.

Does this skill work with both OpenCode and Claude integrations?▼

Yes, the standardized SKILL.md format and frontmatter rules support both OpenCode and Claude skill loading. The structured approach ensures your skill integrates seamlessly with both agent platforms.