opencode-skill-creation

Étoiles0

Forks0

Mis à jour19 mars 2026 à 00:17

Create OpenCode skills that validate and load correctly.

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Source

open-hax

open-hax/eta-mu-pi

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·SOC 15-1252

Explorateur de fichiers

2 fichiers

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

Plus depuis ce dépôt

même dépôt

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