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.

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.