This repository contains reusable agent skills for GitHub project workflows. Each skill is installed separately with the Skills CLI and can then be invoked by name or through a matching natural-language request.

Discovers and writes the shared GitHub workflow config for a repo. It verifies gh, checks project auth, resolves the correct issue repo from remotes or GH_REPO, inspects projects, fields, statuses, labels, and discussion settings, and writes docs/github_memory.md for the other skills to use.

Use it when you want an agent to:

• prepare a new repository for these GitHub workflow skills
• refresh project field IDs or status option IDs after drift
• verify GitHub CLI auth and project access
• identify the correct issue repo when remotes and boards are not obvious

Example prompt:

Use github-setup to prepare this repository for the GitHub project workflow skills.

Selects the next GitHub issue to implement from a project board's Ready column, skips blocked work, breaks ties by the lowest issue number, and then implements the selected issue with TDD and repository guardrails. It reads shared config from docs/github_memory.md.

Use it when you want an agent to:

• pick the next ready issue automatically
• verify dependencies before starting
• create a branch and implement the work
• run guardrails such as lint, typecheck, test, and build

Example prompt:

Use github-next-ready-issue to pick the next ready task from the project board and implement it.

Triages a GitHub Project backlog by moving issues into the correct status, identifying underspecified work, enforcing a Ready cap, and promoting the best unblocked backlog items into Ready. It reads shared config from docs/github_memory.md.

Use it when you want an agent to:

• clean up a project board
• move issues with open sub-issues into Parent Task
• move underspecified issues into Needs Spec
• promote the highest-priority unblocked backlog items into Ready

Example prompt:

Use github-issue-triage to clean up the board and refill the Ready column up to the configured cap.

Processes issues in In review, finds the linked PR, gathers unresolved review feedback, compares it against the issue spec and repo memory, applies valid fixes, and moves the issue to Done after merge. It reads shared config from docs/github_memory.md.

Use it when you want an agent to:

• work through the In review column
• reconcile CodeRabbit or human review feedback
• decide whether feedback should be applied or challenged
• push follow-up fixes and verify merge readiness

Example prompt:

Use github-in-review-reconcile to work the highest-priority issue in In review and address valid review feedback.

The Skills CLI is distributed through npx and installs skills from a GitHub repo using this format:

npx skills add <owner/repo@skill-name>

For this repository, the install commands are:

npx skills add Kodaps/dev-skills@github-setup
npx skills add Kodaps/dev-skills@github-next-ready-issue
npx skills add Kodaps/dev-skills@github-issue-triage
npx skills add Kodaps/dev-skills@github-in-review-reconcile

If you want a non-interactive global install, use:

npx skills add Kodaps/dev-skills@github-setup -g -y
npx skills add Kodaps/dev-skills@github-next-ready-issue -g -y
npx skills add Kodaps/dev-skills@github-issue-triage -g -y
npx skills add Kodaps/dev-skills@github-in-review-reconcile -g -y

Recommended order:

npx skills add Kodaps/dev-skills@github-setup
npx skills add Kodaps/dev-skills@github-next-ready-issue
npx skills add Kodaps/dev-skills@github-issue-triage
npx skills add Kodaps/dev-skills@github-in-review-reconcile

Useful Skills CLI commands:

npx skills find github triage
npx skills check
npx skills update

After installation, you can use a skill in two common ways:

1. Mention the skill by name in your prompt.
2. Ask for the workflow naturally and let the agent match the request to the installed skill.

Examples:

Use github-setup to discover the GitHub project config for this repo and write docs/github_memory.md.

Use github-issue-triage on our project board.

Find the next ready issue with no open blockers and implement it with TDD.

Work through the highest-priority PR in review and reconcile CodeRabbit comments.

These skills are designed for GitHub-based delivery workflows and assume the environment has:

• the GitHub CLI (gh) installed and authenticated
• access to the target repository and GitHub Project
• project metadata available in docs/github_memory.md, typically generated or refreshed with github-setup
• repository-specific conventions documented in files such as AGENTS.md when present

Each skill folder also includes a reference.md file with extra command examples and implementation details.