write-a-skill

Guide users through defining goals and organizing files for OpenCode skills.

5|Updated Jan 14, 2025

Search Tags:#automation #skill development #workflow #best practices #documentation #agent

Ready to run

npx skills add https://github.com/timmo001/dotfiles --skill write-a-skill-timmo001

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/timmo001/dotfiles/tree/main/agents/.config/opencode/skills/write-a-skill
Command: npx skills add https://github.com/timmo001/dotfiles --skill write-a-skill-timmo001

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users create clear, concise, and well-structured OpenCode skills for automation, ensuring correct triggers and minimal supporting files.

Core Features & Use Cases

Skill creation and revision: Guides users through defining task scope and writing effective descriptions.
Workflow optimization: Emphasizes minimal, targeted SKILL.md files with optional supporting materials.
Use Case: When adding a new automation skill, use this skill to generate a well-formed SKILL.md that clearly communicates its purpose and triggers to the agent.

Quick Start

Use the write-a-skill to draft a new skill by describing the task so the agent can generate a focused SKILL.md that meets best practices.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema

How do I create a well-structured OpenCode skill for automation?▼

To create an OpenCode skill, you draft a focused SKILL.md file that defines the task scope, goals, and triggers. This skill guides you through writing the description and organizing supporting files to ensure optimal agent performance.

What is the best way to write a SKILL.md file that an agent can understand?▼

The best way to write a SKILL.md file is to keep it minimal and targeted, ensuring the description clearly communicates the skill's purpose and triggers. This approach optimizes workflow and ensures correct agent execution.

Do I need supporting scripts to develop an OpenCode skill?▼

Supporting scripts are optional when you develop an OpenCode skill. The workflow emphasizes minimal, targeted SKILL.md files, but you can organize and include supporting scripts if the automation task requires them.

How do I revise an existing skill description to improve agent performance?▼

You revise an existing skill description by redefining the task scope and rewriting the description to be clear and concise. This skill helps refine your documentation to ensure the agent correctly triggers and executes the automation.

When should I not use a minimal SKILL.md approach for skill development?▼

You should not use a minimal SKILL.md approach when your automation workflow requires extensive documentation or complex supporting files. If the task scope demands detailed instructions beyond standard best practices, a more comprehensive structure is needed.