agent-skills

agent-skills is a repository of skills for coding agents. This repository is the product. It holds the skills we write here, a small set of third party skills we keep in the repository, and the docs we use to keep OpenCode and Claude Code aligned.

What is in this repository

• skills/ has 19 first party skills.
• docs/ has workflow notes, design specs, and writing guidance.
• docs/best-practices/ is the best place to start if you want to edit a skill.
• .agents/skills/ has 10 third party skills for OpenCode.
• .claude/skills/ mirrors the same 10 skills for Claude Code.
• skills-lock.json records the third party skill set.
• opencode.jsonc stores OpenCode config.

First party skills

Most of the first party skills fall into two workflow groups, one for Jira and one for GitHub. The rest are utility skills you can use on their own.

Jira workflow

• orchestrating-jira-workflow runs the full Jira ticket flow.
• fetching-jira-ticket saves a ticket snapshot to docs/<TICKET_KEY>.md.
• planning-jira-tasks turns that ticket into a task plan in docs/<TICKET_KEY>-tasks.md.
• clarifying-assumptions handles the plan review and the critique pass for each task.
• creating-jira-subtasks creates or updates Jira subtasks after approval.
• planning-jira-task writes the planning files for one task.
• executing-jira-task carries one planned task through implementation and review.

GitHub workflow

• orchestrating-github-workflow runs the full GitHub issue flow.
• fetching-github-issue saves an issue snapshot to docs/<ISSUE_SLUG>.md.
• planning-github-issue-tasks turns that issue into a task plan in docs/<ISSUE_SLUG>-tasks.md.
• clarifying-assumptions is reused here for the same review and critique steps.
• creating-github-child-issues creates or updates child issues after approval.
• planning-github-task writes the planning files for one task.
• executing-github-task carries one planned task through implementation and review.

Utility skills

• generate-handoff-document builds a handoff document for a session that needs to be resumed later.
• validate-implementation-plan reviews implementation plans for missing requirements, weak assumptions, and unnecessary work.
• recency-guard checks answers that depend on current facts.
• pr-creator prepares and opens a pull request from the current branch.
• prompt-structurer turns prose prompts into structured XML prompts.
• workflow-skill-architect helps turn a repeatable process into a reusable skill or set of subagents.

Third party skills kept in the repo

The repository currently includes 10 third party skills. They live in .agents/skills/, are mirrored in .claude/skills/, and are pinned in skills-lock.json.

Skill	Source
code-review-excellence	wshobson/agents
commit-work	softaworks/agent-toolkit
executing-plans	obra/superpowers
gh-cli	github/awesome-copilot
grill-me	mattpocock/skills
humanizer	blader/humanizer
receiving-code-review	obra/superpowers
subagent-driven-development	obra/superpowers
test-driven-development	obra/superpowers
writing-plans	obra/superpowers

Notes for editing

• Skills in this repo need to work in both OpenCode and Claude Code, so keep the format simple and portable.
• Before editing a skill, subagent, or reference file, read the relevant guide in docs/best-practices/README.md.
• There is no formal validator or CI pipeline for skill authoring at the moment, so checks are manual.
• Progress files under docs/ are local working files. Do not commit them.