skills.rest
the-perfect-developer
the-perfect-developerCOMMUNITY
Explore all skills by this author →
GitHub

standard-skill

Structure OpenCode skills with SKILL.md frontmatter and a references directory.

11|2|Updated Feb 18, 2026
Search Tags:#documentation#reference#structure#skill#opencode#progressive-disclosure
One-click install
npx skills add https://github.com/the-perfect-developer/the-perfect-opencode --skill standard-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: standard-skill
Source: https://github.com/the-perfect-developer/the-perfect-opencode/tree/main/.opencode/skills/skill-creation/examples/standard-skill
Command: npx skills add https://github.com/the-perfect-developer/the-perfect-opencode --skill standard-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Standard Skill Example demonstrates how to model a minimal OpenCode skill with a YAML frontmatter header and a lightweight body, enabling predictable discovery and easy onboarding.

Core Features & Use Cases

  • Clear frontmatter-based identity (name and description) that powers discovery.
  • Progressive disclosure pattern with a SKILL.md as the core and optional references for deeper guidance.
  • Simple, repeatable pattern to teach, document, and showcase OpenCode skills.

Quick Start

Provide the minimal standard skill structure by showing the SKILL.md frontmatter and the references folder layout.

Frequently Asked Questions about standard-skill

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

FAQPage Schema
How do I structure an OpenCode skill with YAML frontmatter?▼

To structure an OpenCode skill, create a SKILL.md file with YAML frontmatter declaring a name and description, then add optional directories like references for extended content to enable predictable discovery.

What is progressive disclosure in skill documentation?▼

Progressive disclosure is a documentation pattern where core content resides in SKILL.md and detailed references load on demand, allowing users to access deeper guidance only when needed without overwhelming the initial view.

How do I set up a references directory for OpenCode skills?▼

Set up a references directory by creating an optional folder alongside your SKILL.md file to store extended documentation, which the skill loads on demand when deeper guidance is requested.

Do I need dependencies to create a standard OpenCode skill?▼

No dependencies are required to create a standard OpenCode skill. The minimal structure only needs a SKILL.md file with YAML frontmatter declaring a name and description, making onboarding simple.

When should I use progressive disclosure patterns for documentation?▼

Use progressive disclosure patterns when your documentation requires a lightweight core summary in SKILL.md with optional deeper references, preventing information overload while maintaining detailed guidance availability.

Related Skills

Explore More Software Engineering Skills→
alexajunoalexajuno

template-skill

Demonstrates YAML frontmatter and Markdown structure for Anthropic Agent Skills.

Community
Basic
TalentedleoTalentedleo

peter-lynch

Summarize Peter Lynch's investment framework into actionable stock evaluation guidance.

Community
Intermediate
yazelinyazelin
31

task-scheduler

Manage and execute scheduled tasks via Agents or Skill Scripts.

Community
Intermediate
winsorllcwinsorllc

json-yaml

Validate, format, convert, query, flatten, unflatten, and merge JSON, YAML, and TOML data files.

Community
Intermediate