---

name: skill-writer description: Create and manage reusable agent skills with proper structure and frontmatter license: MIT compatibility: opencode metadata: audience: developers workflow: skill-creation

Skill Writer

What I do

• Create new skills with proper directory structure
• Generate valid YAML frontmatter for SKILL.md files
• Ensure skill names follow naming conventions
• Provide templates for different types of skills
• Validate skill structure before creation
• Update skill permissions in opencode.json if needed

When to use me

Use this when you want to:

• Create a new reusable skill for opencode agents
• Standardize skill creation across projects
• Ensure skills follow opencode conventions
• Set up skill permissions and access controls

How I work

1. Ask about the skill's purpose and target audience
2. Suggest an appropriate name following naming conventions
3. Generate the proper directory structure
4. Create the SKILL.md with valid frontmatter
5. Provide content templates based on skill type
6. Configure permissions if needed

Naming conventions I follow

• Lowercase alphanumeric with single hyphen separators
• 1-64 characters
• Must match directory name
• Cannot start or end with hyphen
• No consecutive hyphens

Skill types I can create

• Code skills: For code generation, analysis, or review
• Workflow skills: For multi-step processes and automation
• Documentation skills: For docs, READMEs, and technical writing
• Testing skills: For test creation and validation
• Configuration skills: For setup and config management
• Debugging skills: For troubleshooting and issue resolution

Permissions I can configure

• Global permissions in opencode.json
• Agent-specific permissions
• Pattern-based access controls
• Allow/deny/ask permission levels

Example skills I've created

• git-release: Create consistent releases and changelogs
• code-review: Perform thorough code reviews
• test-generator: Generate comprehensive test suites
• doc-writer: Create technical documentation

Ask me to create any skill you need, and I'll guide you through the process with proper structure and validation.