agentdev-command-authoring

Defines quality criteria and review standards for authoring OpenCode command definitions.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-command-authoring-yogata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentdev-command-authoring
Source: https://github.com/yogata/agent-dev-flow/tree/main/src/opencode/skills/agentdev-command-authoring
Command: npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-command-authoring-yogata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing OpenCode command definitions without clear standards leads to bloated files, misplaced logic, and inconsistent frontmatter. This Skill provides concrete quality criteria so commands stay thin, delegating detailed judgment tables to skills and deterministic processing to scripts. ## Core Features & Use Cases - Frontmatter and Structure Rules: Enforces a description-only frontmatter, integer-only top-level steps, and runtime path conventions (.opencode/...) instead of source paths. - Size and Responsibility Thresholds: Defines line count targets (100 lines ideal, 150 operational limit), step counts (5-12), token budgets, and clear rules for what belongs in a command versus a skill, reference, or script. - Review Checklists and DoD: Supplies a Definition of Done and review checklist covering delegation contracts, subagent edit safety, common policy identifiers (POL-), and writing quality. - Use Case: When creating a new /agentdev/* command or refactoring an oversized one, load this Skill to decide what to extract into orchestration skills or scripts and verify the result against the checklist. ## Quick Start Review my new OpenCode command definition against the command authoring standards and tell me what to extract into skills or scripts.

Frequently Asked Questions about agentdev-command-authoring

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

FAQPage Schema
How do I write an OpenCode command definition?

Keep the command thin: use a description-only frontmatter, define Input, Output, Guardrails, and 5-12 high-level integer-numbered steps. Move detailed judgment tables to skill references and deterministic processing to scripts.

What belongs in a command versus a skill or script?

Commands hold the public API and high-level execution skeleton. Detailed classification tables and schemas go to skill references, large state machines go to orchestration skills, and deterministic transformations or validations go to scripts.

What is the maximum line count for an OpenCode command file?

The target is 100 lines or fewer, with 150 lines as the operational upper limit. Files between 151-200 lines require a concrete extraction plan, and anything over 200 lines must be split into skills, references, or scripts.

Which frontmatter fields are allowed in command definitions?

Only the description field is permitted. Fields like agent, pattern, workflow_route, branch_type, and labels are prohibited and detected as errors, since agent assignment is handled by harness-side configuration.

Why should commands use runtime paths instead of source paths?

Source paths under src/ exist only in the development repository and are not projected into consumer projects. Commands must reference runtime paths starting with .opencode/ so templates, skills, and references resolve correctly at execution time.

When should I not use this command authoring skill?

Do not use it for creating skills, writing templates, or general coding tasks. It covers only command definition quality; skill quality standards are handled by the separate agentdev-skill-authoring skill.