add-skill

Create and validate SKILL.md files with YAML frontmatter for agent skills.

Updated Aug 23, 2021

Search Tags:#documentation #yaml #guidelines #frontmatter #opencode #skill-creation

Ready to run

npx skills add https://github.com/undg/.dot --skill add-skill-undg

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill authoring and governance for agent capabilities, providing a consistent SKILL.md frontmatter and structure so teams can quickly create, review, and publish skills without ambiguity.

Core Features & Use Cases

Enforces a consistent frontmatter (name and description) at the top of SKILL.md.
Guides structure with optional references, scripts, and assets directories to organize skill content.
Supports OpenCode or Claude workflows by aligning skill documentation with project standards and discovery.
Useful when writing new SKILL.md files, updating descriptions, or restructuring skill content for reuse.

Quick Start

Create a new skill by adding SKILL.md with proper frontmatter and content, then populate the body with actionable guidance.

Frequently Asked Questions about add-skill

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

FAQPage Schema

How do I standardize agent skill creation with SKILL.md frontmatter?▼

To standardize agent skill creation, use SKILL.md as the entry point and enforce YAML frontmatter with name and description at the root. This structure enables predictable discovery, frontmatter validation, and structured guidance for teams.

What is the correct structure for organizing OpenCode skill content and directories?▼

The correct structure for organizing OpenCode skill content designates SKILL.md as the entry point and supports optional directories: scripts/, references/, and assets/ to separate and structure skill components for reuse.

How do I write valid YAML frontmatter for a new SKILL.md file?▼

Write valid YAML frontmatter for a SKILL.md file by placing name and description fields at the root level. This consistent frontmatter ensures frontmatter validation and predictable discovery across OpenCode or Claude workflows.

Does this skill governance approach work for both OpenCode and Claude workflows?▼

Yes, this skill governance approach works for both OpenCode and Claude workflows by aligning skill documentation with project standards and discovery, allowing teams to review and publish skills without ambiguity.

What's the best way to document and restructure agent skills for team reuse?▼

The best way to document and restructure agent skills for team reuse is to populate the SKILL.md body with actionable guidance while maintaining consistent frontmatter and utilizing references, scripts, and assets directories to organize content.

When do I need to use the scripts, references, and assets directories in skill creation?▼

You use the scripts, references, and assets directories in skill creation when you need to organize complex skill content. These optional directories help separate executable scripts, supporting documentation, and static files for structured guidance.