Agent skill

Creating Opencode Agents

by pr-pm in pr-pm/prpm

A skill your agent uses when creating OpenCode agents - provides markdown format with YAML frontmatter, mode/tools/permission configuration, and best practices for specialized AI assistants

MITAuto-check passedDevelopment

Install Creating Opencode Agents

skills CLI
$ npx skills add pr-pm/prpm --skill creating-opencode-agents -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pr-pm/prpm creating-opencode-agents --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pr-pm/prpm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/creating-opencode-agents .claude/skills/creating-opencode-agents && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
creating-opencode-agents
GitHub stars
122
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
465 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when creating OpenCode agents - provides markdown format with YAML frontmatter, mode/tools/permission configuration, and best practices for specialized AI assistants

  • Works in 5 steps: Define expertise area clearly → List specific focus areas → Specify standards/conventions → …
  • Creating OpenCode agents - provides markdown format with YAML frontmatter
  • SKILL.md covers When to Use, Quick Reference, Common Patterns and Tools Configuration, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Creating Opencode Agents is an agent skill from pr-pm/prpm. Use when creating OpenCode agents - provides markdown format with YAML frontmatter, mode/tools/permission configuration, and best practices for specialized AI assistants

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: The universal registry for AI coding tools. The licence is MIT.

When your agent uses it

  • Creating OpenCode agents - provides markdown format with YAML frontmatter
  • Mode/tools/permission configuration
  • Best practices for specialized AI assistants

Example prompts

  • “/creating-opencode-agents”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Define expertise area clearly
  2. List specific focus areas
  3. Specify standards/conventions
  4. Provide examples when helpful
  5. Set clear expectations

What it can do on your machine

Read from SKILL.md and the folder at commit 5f993e6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown, yaml, bash and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • opencode.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Creating Opencode Agents loads about 2k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 465 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pr-pm/prpm at commit 5f993e6, republished under its MIT licence (© pr-pm). 465 words, ~2,004 tokens.

Download SKILL.mdSave it as .claude/skills/creating-opencode-agents/SKILL.md (or your agent's skills folder).
name
creating-opencode-agents
description
Use when creating OpenCode agents - provides markdown format with YAML frontmatter, mode/tools/permission configuration, and best practices for specialized AI assistants

Creating OpenCode Agents

Expert guidance for creating OpenCode AI agents with proper configuration, tools, and permissions.

When to Use

Use when:

  • User asks to create an OpenCode agent
  • Need specialized AI assistant for specific tasks
  • Building domain-focused development tools
  • Configuring agent tools and permissions

Don't use for:

  • OpenCode plugins (use creating-opencode-plugins skill)
  • OpenCode slash commands (different format)
  • Generic AI prompts (not OpenCode-specific)

Quick Reference

File Location
  • Project: .opencode/agent/<name>.md
  • Global: ~/.config/opencode/agent/<name>.md
Minimal Agent Structure
markdown
---
description: Brief explanation of the agent's purpose
mode: all
---

System prompt content here...
Required Fields
  • description (string): Brief explanation of the agent's purpose (REQUIRED)
Optional Fields
FieldTypeDescription
modeprimary | subagent | allHow agent can be used (default: all)
modelstringOverride model (e.g., anthropic/claude-sonnet-4-6)
temperaturenumberResponse randomness 0.0-1.0
promptstringPath to prompt file: {file:./path/to/prompt.txt}
maxStepsnumberMaximum iterations (unlimited if unset)
toolsobjectEnable/disable tools with boolean values
permissionobjectTool access: ask, allow, or deny
disablebooleanDeactivate the agent
Agent Modes
  • primary: Main assistant for direct interaction, switchable via Tab key
  • subagent: Specialized assistant invoked by primary agents or @mentions
  • all: Default; usable in both contexts

Common Patterns

Code Reviewer (Read-Only)
markdown
---
description: Reviews code for best practices and security
mode: subagent
model: anthropic/claude-sonnet-4-6
temperature: 0.1
tools:
  write: false
  edit: false
  bash: false
  read: true
  grep: true
  glob: true
permission:
  edit: deny
  bash: deny
---

# Code Review Agent

You are an expert code reviewer with deep knowledge of software engineering principles.

## Instructions

- Check for code smells and anti-patterns
- Verify test coverage
- Ensure documentation exists
- Review error handling and security
- Suggest improvements with examples

## Review Checklist

- [ ] Code follows project conventions
- [ ] Tests are comprehensive
- [ ] No security vulnerabilities
- [ ] Documentation is clear
Backend Developer
markdown
---
description: Node.js/Express API development with database optimization
mode: all
temperature: 0.3
tools:
  read: true
  write: true
  edit: true
  bash: true
  grep: true
  glob: true
permission:
  bash:
    "npm test": allow
    "npm run *": allow
    "git *": ask
    "*": deny
---

# Backend Development Agent

You are a backend development expert specializing in Node.js, Express, and database optimization.

## Focus Areas

- RESTful API design
- Input validation and error handling
- Database query optimization
- Security best practices

## Standards

- Always use async/await
- Implement proper logging
- Validate all inputs
- Use TypeScript interfaces
Test Writer
markdown
---
description: Writes comprehensive test suites with high coverage
mode: subagent
temperature: 0.2
maxSteps: 50
tools:
  read: true
  write: true
  bash: true
permission:
  bash:
    "npm test*": allow
    "*": deny
---

# Test Writer Agent

You are a testing expert focused on comprehensive test coverage.

## Test Requirements

- Unit tests for all functions
- Edge case coverage
- Proper mocking
- AAA pattern (Arrange, Act, Assert)
- Descriptive test names

## Frameworks

- Vitest for unit tests
- Playwright for E2E
- MSW for API mocking
Documentation Writer (Limited Tools)
markdown
---
description: Technical documentation and API reference writer
mode: subagent
temperature: 0.5
tools:
  read: true
  write: true
  edit: true
  bash: false
---

# Documentation Agent

You write clear, comprehensive technical documentation.

## Focus

- API reference documentation
- README files
- Architecture docs
- Code comments and JSDoc

## Style

- Clear and concise
- Include examples
- Use proper markdown formatting
- Follow project documentation standards

Tools Configuration

Available Tools
ToolDescription
readRead file contents
writeCreate new files
editModify existing files
bashExecute shell commands
grepSearch file contents
globFind files by pattern
webfetchFetch web content
websearchSearch the web
Wildcard Patterns

Disable groups of tools with wildcards:

yaml
tools:
  mymcp_*: false  # Disable all MCP tools starting with mymcp_

Permission Configuration

Simple Permissions
yaml
permission:
  edit: ask      # Prompt before editing
  bash: deny     # Block all bash commands
  webfetch: allow  # Allow web fetching
Per-Command Bash Permissions
yaml
permission:
  bash:
    "git push": ask    # Ask before pushing
    "git *": allow     # Allow other git commands
    "npm test": allow  # Allow testing
    "*": deny          # Deny everything else

Temperature Guidelines

TemperatureUse Case
0.0-0.2Code review, debugging, analysis
0.3-0.5General development, refactoring
0.6-1.0Documentation, brainstorming, creative work
Show full SKILL.md (207 more words)Show less

Common Mistakes

MistakeProblemFix
Missing descriptionRequired fieldAdd description in frontmatter
Granting all toolsSecurity riskOnly grant necessary tools
Vague promptIneffective agentBe specific about domain and tasks
Wrong modeAgent not accessibleUse all for flexibility
No tool restrictionsAgent can do anythingUse tools/permission to limit scope

Best Practices

Naming
  • Use kebab-case: code-reviewer, not CodeReviewer
  • Be specific: react-testing-expert, not helper
  • Indicate domain: aws-infrastructure, mobile-ui-designer
Prompts
  1. Define expertise area clearly
  2. List specific focus areas
  3. Specify standards/conventions
  4. Provide examples when helpful
  5. Set clear expectations
Security
  1. Grant minimum necessary tools
  2. Use permissions to restrict dangerous operations
  3. Disable bash for read-only agents
  4. Use glob patterns for bash permissions
  5. Consider maxSteps for long-running agents

PRPM Integration

Package Manifest (prpm.json)
json
{
  "name": "@username/my-agent",
  "version": "1.0.0",
  "description": "My OpenCode agent",
  "format": "opencode",
  "subtype": "agent",
  "files": [".opencode/agent/my-agent.md"],
  "tags": ["opencode", "agent", "development"]
}
Installation
bash
# Install from registry
prpm install @username/agent-name --format opencode

# Installs to: .opencode/agent/<agent-name>.md
Publishing
bash
prpm publish

Navigation & Usage

  • Tab key: Switch between primary agents
  • @ mention: Invoke subagents (e.g., @code-reviewer check this function)
  • <Leader>+Right/Left: Navigate parent/child sessions

Troubleshooting

Agent Not Found
  • Check file is in .opencode/agent/
  • Verify .md extension
  • Validate YAML frontmatter syntax
Tools Not Working
  • Verify tool names (lowercase in OpenCode)
  • Check permission settings
  • Ensure mode allows tool access
Agent Ineffective
  • Be more specific in prompt
  • Add concrete examples
  • Reference team standards
  • Structure with markdown headers

Schema Reference: packages/converters/schemas/opencode.schema.json

Documentation: https://opencode.ai/docs/agents/

© pr-pm, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/creating-opencode-agents of pr-pm/prpm.

Open the folder on GitHubat commit 5f993e6

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in pr-pm/prpm, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Creating Opencode Agents next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Creating Opencode Agents compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Creating Opencode Agents this skillpr-pm/prpm1221 repos~2kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k24 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 24 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Guidelines

    akash-network/node

    Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.

    1.1k GitHub starsUsed in 22 repos~577 tokens
    DevelopmentAuto-check passed

More from pr-pm/prpm

All 35 skills in this repo
  • Reference for writing Claude Code agent files: location, frontmatter fields, validation limits, tool and model choices, and the required content format.

    122 GitHub starsUsed in 3 repos~4k tokens
    Auto-check passed
  • Covers how to build, configure and publish Claude Code hooks: event types, exit codes, JSON I/O, and PRPM packaging.

    122 GitHub starsUsed in 2 repos~3.9k tokens
    Auto-check: notes
  • Shows how to write .claude/rules/ files correctly: paths frontmatter instead of globs, quoted glob patterns, global rules and conversion of Cursor rules.

    122 GitHub starsUsed in 2 repos~551 tokens
    Auto-check passed
  • Reference for writing portable Agent Skills packages, covering SKILL.md frontmatter limits, name rules, directory layout and where Codex CLI, GitHub Copilot and Amp look for skills.

    122 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • A skill your agent uses when building custom Kiro AI agents or when user asks for agent configurations - provides JSON structure, tool configuration, prompt patterns, and security best practices for…

    122 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • A skill your agent uses when implementing Stripe webhook endpoints and getting 'Raw body not available' or signature verification errors - provides raw body parsing solutions and subscription period…

    122 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed

Categories

Questions about Creating Opencode Agents

What does Creating Opencode Agents do?

A skill your agent uses when creating OpenCode agents - provides markdown format with YAML frontmatter, mode/tools/permission configuration, and best practices for specialized AI assistants. Creating Opencode Agents is an agent skill from pr-pm/prpm.

When should I use Creating Opencode Agents?

Creating Opencode Agents fits situations like: creating OpenCode agents - provides markdown format with YAML frontmatter; mode/tools/permission configuration; best practices for specialized AI assistants.

How do I install Creating Opencode Agents in Claude Code?

Run `npx skills add pr-pm/prpm --skill creating-opencode-agents -a claude-code`. Or copy the skill folder (.claude/skills/creating-opencode-agents in pr-pm/prpm) into .claude/skills/creating-opencode-agents in your project. Claude Code loads it when a task matches its description.

How do I install Creating Opencode Agents in Codex?

Run `npx skills add pr-pm/prpm --skill creating-opencode-agents -a codex`. Or copy the skill folder (.claude/skills/creating-opencode-agents in pr-pm/prpm) into .agents/skills/creating-opencode-agents in your project. Codex loads it when a task matches its description.

Can I use Creating Opencode Agents in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pr-pm/prpm --skill creating-opencode-agents -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/creating-opencode-agents, .gemini/skills/creating-opencode-agents, .github/skills/creating-opencode-agents and .opencode/skills/creating-opencode-agents in your project.

What does Creating Opencode Agents need to run?

SKILL.md names no scripts, command-line tools or credentials: Creating Opencode Agents is instructions for the agent only. Our summary lists: Node.js.

Does Creating Opencode Agents access the network?

SKILL.md names 1 domain. As links in the text: opencode.ai. This is read from the text; nothing was executed.

Is Creating Opencode Agents safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Creating Opencode Agents use?

Creating Opencode Agents is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Creating Opencode Agents use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Creating Opencode Agents?

Skills that share tags, products or a category with Creating Opencode Agents: Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Creating Opencode Agents?

pr-pm (a GitHub organization) maintains it in pr-pm/prpm, which has 122 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 6, 2026.

Source: pr-pm/prpm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.