skills.rest
sustinbebustin
sustinbebustinCOMMUNITY
Explore all skills by this author →
GitHub

build-skill

Create and validate OpenCode agent skills with SKILL.md structure and frontmatter.

Updated Feb 19, 2026
Search Tags:#skill development#documentation#validation#scaffolding#agent framework#opencode
One-click install
npx skills add https://github.com/sustinbebustin/.dotfiles --skill build-skill-sustinbebustin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-skill
Source: https://github.com/sustinbebustin/.dotfiles/tree/main/home/.config/opencode/skill/build-skill
Command: npx skills add https://github.com/sustinbebustin/.dotfiles --skill build-skill-sustinbebustin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides the foundational knowledge and tools to create, validate, and structure effective skills for OpenCode agents, ensuring discoverability and efficient operation.

Core Features & Use Cases

  • Skill Structure Guidance: Understand the anatomy of a skill, from minimal to complex configurations.
  • Frontmatter Specification: Learn the mandatory and optional fields for SKILL.md and their validation rules.
  • Resource Management: Know when and how to use scripts/, references/, and assets/ directories.
  • Use Case: When starting a new agent feature that requires specialized knowledge or automation, use this Skill to scaffold and validate the new skill's SKILL.md and directory structure before implementation.

Quick Start

Use the build-skill skill to scaffold a new skill named 'my-new-skill' in the current directory.

Frequently Asked Questions about build-skill

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

FAQPage Schema
How do I structure an OpenCode skill for agent framework integration?▼

To structure an OpenCode skill, define the required frontmatter fields in a SKILL.md file and organize supporting files into scripts, references, and assets directories to ensure proper agent discoverability.

What frontmatter fields are required in SKILL.md for OpenCode?▼

Required frontmatter fields in SKILL.md specify mandatory metadata for OpenCode agents. Validation rules ensure adherence to naming conventions and progressive disclosure patterns for efficient skill operation.

How do I scaffold a new OpenCode skill and validate its configuration?▼

Scaffold a new OpenCode skill by generating the directory structure and SKILL.md file, then run provided validation scripts to review frontmatter requirements and debug configuration issues before implementation.

When should I use the scripts and references directories in skill development?▼

Use the scripts directory for executable validation and scaffolding logic, and the references directory for static documentation resources, ensuring progressive disclosure of information to the agent framework.

What are the limitations when building skills for OpenCode agents?▼

Limitations when building OpenCode skills include strict adherence to frontmatter validation rules and naming conventions. Failure to follow progressive disclosure patterns reduces agent discoverability and operational efficiency.

Related Skills

Explore More Software Engineering Skills→
4tikhonov4tikhonov
3

project-init

Initialize a FIRE project by detecting workspace type and generating standards templates.

Community
Basic
giosuetedeschi-specgiosuetedeschi-spec

agent-manager-skill

Manage CLI agent lifecycles in tmux sessions with cron scheduling.

Community
Intermediate
rodrigobranasrodrigobranas
1

skill-best-practices

Validate agent skill metadata against the agentskills.io specification.

Community
Intermediate
hwj123hwjhwj123hwj
4

wizard

Guide users through interactive bash procedures with configurable stages.

Community
Intermediate