skills.rest
different-ai
different-aiOFFICIAL
Explore all skills by this author →
𝕏@benjaminshafiiGitHub

skill-authoring

Define OpenCode skills with SKILL.md frontmatter and validate discoverability.

249|47|Updated Nov 5, 2024
Search Tags:#workflow#yaml#frontmatter#skill-discovery#OpenCode#skill-authoring#repository-automation
One-click install
npx skills add https://github.com/different-ai/agent-bank --skill skill-authoring-different-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/different-ai/agent-bank/tree/main/.opencode/skill/skill-authoring
Command: npx skills add https://github.com/different-ai/agent-bank --skill skill-authoring-different-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode skill authoring is a structured process that reduces ambiguity and ensures all new skills are discoverable and validated within the repo.

Core Features & Use Cases

  • Standardized skill definition using SKILL.md frontmatter with required fields like name and description.
  • Enforced placement and naming rules so new skills are correctly discovered by the skill tool.
  • Validation workflow that checks for proper frontmatter, folder structure, and alignment with OpenCode discovery.

Quick Start

Create a new skill by adding .opencode/skill/<name>/SKILL.md with YAML frontmatter including name and description, then ensure the folder name matches the skill name. Run the skill discovery to confirm your skill appears in the skill tool list.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I create and register a new OpenCode skill in my repository?▼

To create an OpenCode skill, add a SKILL.md file at .opencode/skill/<name>/SKILL.md with YAML frontmatter containing the name and description fields, then verify its discoverability with the skill tool.

What YAML frontmatter is required for an OpenCode SKILL.md file?▼

An OpenCode SKILL.md file requires YAML frontmatter with at least the name and description fields defined, ensuring the skill is properly indexed by the repository-level discovery mechanism.

Why is my custom OpenCode skill not showing up in the skill tool list?▼

Your OpenCode skill may not appear if the folder name does not match the skill name, the SKILL.md file is misplaced outside .opencode/skill/, or the required YAML frontmatter fields are missing or invalid.

Does OpenCode skill discovery enforce specific folder naming rules?▼

Yes, OpenCode skill discovery enforces strict placement and naming rules, requiring the folder name at .opencode/skill/<name>/ to exactly match the name defined in the SKILL.md YAML frontmatter.

What is the validation workflow for publishing OpenCode skills?▼

The OpenCode skill validation workflow checks for proper YAML frontmatter, correct folder structure under .opencode/skill/, and alignment with repository-level discovery to ensure the skill is registered and discoverable.

Related Skills

Explore More Software Engineering Skills→
nnexainnexai
1

gsd-new-workspace

Creates isolated Git worktrees or clones with planning directories for multi-repo tasks.

Community
Intermediate
kandengkandeng
2

hello-tool-plugin 工具一

Validate Openclaw gateway plugin tool discovery and execution accessibility.

Community
Basic
ziltorianziltorian

vscode-agent-rules

Create VS Code Copilot instruction and prompt templates with YAML frontmatter.

Community
Intermediate
patrickhaahrpatrickhaahr

command-creator

Create reusable Opencode commands with frontmatter and Markdown prompt bodies.

Community
Basic