opencode-skill-creation

Stars0

Forks0

UpdatedMarch 19, 2026 at 00:17

Create OpenCode skills that validate and load correctly.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

open-hax

open-hax/eta-mu-pi

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

SKILL.md

readonly

name	opencode-skill-creation
description	Create OpenCode skills that validate and load correctly.

Skill: OpenCode Skill Creation

Goal

Create new OpenCode skills that validate, load reliably, and follow repo conventions.

Use This Skill When

The user asks to create a new OpenCode skill or add reusable workflow guidance.
You need to standardize repeated workflows into a dedicated skill.
You are expanding the OpenCode skill catalog under .opencode/.

Do Not Use This Skill When

The change is a one-off edit or quick fix.
You are only updating a single file without new workflow guidance.

Inputs

User request and target workflow context.
Existing skills in .opencode/skill/ and ~/.pi/agent/skills/.
AGENTS.md skill list and any local agent guidance.

OpenCode Compatibility Rules

Location: OpenCode discovers skills at:
- Project: .opencode/skill/<name>/SKILL.md
- Global: ~/.config/opencode/skill/<name>/SKILL.md
- Claude-compatible (project): .claude/skills/<name>/SKILL.md
- Claude-compatible (global): ~/.claude/skills/<name>/SKILL.md
Frontmatter: SKILL.md must begin with YAML frontmatter. Only these fields are recognized: name, description, license, compatibility, metadata.
Name rules:
- 1–64 chars
- lowercase alphanumeric with single hyphen separators
- no leading/trailing hyphen, no --
- must match the directory name exactly
Description rules: 1–1024 chars, specific enough for the agent to choose correctly.
Discovery: For project-local paths, OpenCode walks up from the current working directory to the git worktree and loads matching skills along the way.

Steps

Review .opencode/skill/skill-authoring/SKILL.md for the standard template.
Pick a valid skill name (kebab-case) and folder name.
Create the canonical skill at ~/.pi/agent/skills/<name>/SKILL.md so Codex can load it.
Ensure SKILL.md starts with OpenCode-compatible frontmatter.
Create a project-local link for OpenCode:
- mkdir -p .opencode/skill/<name>
- ln -s ~/.pi/agent/skills/<name>/SKILL.md .opencode/skill/<name>/SKILL.md
Write clear Goal, Use This Skill When, and Do Not Use This Skill When gates.
Define Inputs, Steps, Output, and References.
Cross-link related skills instead of duplicating content.
Update AGENTS.md to reference the new skill.

Output

A new skill folder under ~/.pi/agent/skills/<name>/SKILL.md.
A project-local OpenCode-visible link at .opencode/skill/<name>/SKILL.md.
Updated AGENTS.md entries referencing the new skill.

References

Skill authoring template: .opencode/skill/skill-authoring/SKILL.md
Skill index guidance: AGENTS.md

More from this repository

same repository

docker-no-root

open-hax/eta-mu-pi

Never run Docker containers as root. Enforce USER directive in Dockerfiles and user: in compose files. Database images are the only exception.

2026-04-090

pnpm-workspace-migration

open-hax/eta-mu-pi

Handle packages migrating between pnpm workspaces. Clean stale root copies, update workspace configs, fix broken workspace:* references.

2026-04-090

session-source-recovery

open-hax/eta-mu-pi

Recover lost source files from pi session history when files were deleted but never committed to git.

2026-04-090

clock-model-evolver

open-hax/eta-mu-pi

Improve the Hormuz clock model through new signal classes, schema changes, uncertainty modeling, and better rendering or branch logic

2026-04-060

fork-tax-concurrent-agent-guardrails

open-hax/eta-mu-pi

Revise fork-tax protocols so they assume concurrent agents by default in shared workspaces, forbid destructive repo-wide cleanup of unrelated dirt, and require path-scoped staging plus explicit blocker recording.

2026-04-040

fork-tax

open-hax/eta-mu-pi

Persist the full working state into git (commit + tag + push + manifest artifacts) as a deterministic handoff snapshot. Use when the user requests Π / fork tax / full dump.

2026-04-040

Skill: OpenCode Skill Creation

Goal

Create new OpenCode skills that validate, load reliably, and follow repo conventions.

Use This Skill When

The user asks to create a new OpenCode skill or add reusable workflow guidance.

You need to standardize repeated workflows into a dedicated skill.

You are expanding the OpenCode skill catalog under .opencode/.

Do Not Use This Skill When

The change is a one-off edit or quick fix.

You are only updating a single file without new workflow guidance.

Inputs

User request and target workflow context.

Existing skills in .opencode/skill/ and ~/.pi/agent/skills/.

AGENTS.md skill list and any local agent guidance.

OpenCode Compatibility Rules

Location: OpenCode discovers skills at:

Project: .opencode/skill/<name>/SKILL.md
Global: ~/.config/opencode/skill/<name>/SKILL.md
Claude-compatible (project): .claude/skills/<name>/SKILL.md
Claude-compatible (global): ~/.claude/skills/<name>/SKILL.md

Frontmatter: SKILL.md must begin with YAML frontmatter. Only these fields are recognized: name, description, license, compatibility, metadata.

Name rules:

1–64 chars
lowercase alphanumeric with single hyphen separators
no leading/trailing hyphen, no --
must match the directory name exactly

Description rules: 1–1024 chars, specific enough for the agent to choose correctly.

Discovery: For project-local paths, OpenCode walks up from the current working directory to the git worktree and loads matching skills along the way.

Steps

Review .opencode/skill/skill-authoring/SKILL.md for the standard template.

Pick a valid skill name (kebab-case) and folder name.

Create the canonical skill at ~/.pi/agent/skills/<name>/SKILL.md so Codex can load it.

Ensure SKILL.md starts with OpenCode-compatible frontmatter.

Create a project-local link for OpenCode:

mkdir -p .opencode/skill/<name>
ln -s ~/.pi/agent/skills/<name>/SKILL.md .opencode/skill/<name>/SKILL.md

Write clear Goal, Use This Skill When, and Do Not Use This Skill When gates.

Define Inputs, Steps, Output, and References.

Cross-link related skills instead of duplicating content.

Update AGENTS.md to reference the new skill.

Output

A new skill folder under ~/.pi/agent/skills/<name>/SKILL.md.

A project-local OpenCode-visible link at .opencode/skill/<name>/SKILL.md.

Updated AGENTS.md entries referencing the new skill.

References

Skill authoring template: .opencode/skill/skill-authoring/SKILL.md

Skill index guidance: AGENTS.md