build-skill

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

Updated Nov 3, 2019
One-click install
npx skills add https://github.com/gil0mendes/dotfiles --skill build-skill-gil0mendes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-skill
Source: https://github.com/gil0mendes/dotfiles/tree/main/configs/opencode/skill/build-skill
Command: npx skills add https://github.com/gil0mendes/dotfiles --skill build-skill-gil0mendes

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive framework and best practices for creating, validating, and organizing skills for the OpenCode agent, ensuring consistency and efficiency in skill development.

Core Features & Use Cases

  • Skill Structure Guidance: Understand the anatomy of a skill, from minimal to complex setups.
  • Frontmatter Specification: Learn the mandatory and optional fields for SKILL.md and their validation rules.
  • Resource Management: Utilize scripts/, references/, and assets/ directories effectively.
  • Best Practices: Follow guidelines on naming conventions, file size limits, and progressive disclosure for optimal performance.
  • Use Case: When starting a new skill for your project, use this Skill to scaffold the directory structure, create a valid SKILL.md with the correct frontmatter, and understand how to organize supporting documentation and scripts.

Quick Start

Use the build-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 agent skill for optimal performance?

To structure an OpenCode agent skill, create a root SKILL.md file with YAML frontmatter and organize supporting content into scripts/, references/, and assets/ directories, applying progressive disclosure for token efficiency.

What is progressive disclosure in skill development and when should I use it?

Progressive disclosure in skill development is the practice of organizing SKILL.md files and supporting directories to reveal information incrementally, reducing token consumption and optimizing agent performance during execution.

What are the required YAML frontmatter fields for a valid SKILL.md file?

A valid SKILL.md file requires specific YAML frontmatter fields that define mandatory metadata for the OpenCode agent, including naming conventions and validation rules that must be strictly followed for proper skill recognition.

Can I use scripts and references directories for complex skill setups?

Yes, you can use scripts and references directories for complex skill setups, allowing you to separate executable logic from documentation and manage resource files effectively within the OpenCode agent framework.

What are the file size limits and naming conventions for OpenCode skills?

OpenCode skills enforce specific file size limits and naming conventions to ensure optimal agent performance, requiring developers to follow best practices for SKILL.md validation and resource management across the skill directory structure.

Why does my OpenCode skill fail validation during agent execution?

OpenCode skill validation fails when the SKILL.md file contains incorrect YAML frontmatter, violates naming conventions, or exceeds file size limits, preventing the agent framework from properly parsing and loading the skill structure.