agent-workflow-skills

Claude Code plugin providing a full-cycle agent workflow: session context loading, requirements interviews, task tracking, ADRs, quality gates, and a Codex review loop.

Skills

Skill	Trigger	Purpose	Docs
session-start	Auto (SessionStart hook)	Load git state, memory, WIP tasks, lessons	docs · SKILL.md
task-start	Before any implementation	Route to dive-in, recovery, or requirements interview	docs · SKILL.md
task-end	Before marking done	Quality gates, docs, doc-drift janitor, ADR, Codex review loop (prefers the codex-review-loop skill; inline 3-round fallback)	docs · SKILL.md

Install

Add to ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "agent-workflow-skills": {
      "source": {
        "source": "git",
        "url": "https://github.com/djm204/agent-workflow-skills.git"
      }
    }
  }
}

Then install via Claude Code:

/plugins install agent-workflow@agent-workflow-skills

Hermes Agent install

This repository also publishes Hermes-compatible skill packages under skills/:

Skill	Purpose
codex-review-loop	Drive the GitHub chatgpt-codex-connector review loop until a PR is clean.
resolve-issues	Resolve GitHub issues priority-first with one branch/PR per issue and Codex review gating.
hermes-session-start	Start/recover Hermes sessions with compact project and work-state context.
hermes-task-start	Kick off non-trivial Hermes implementation tasks with the right planning/recovery path.
hermes-task-end	Run Hermes task completion quality gates before claiming done.
pm-swarm	Create and operate a persistent PM-led Hermes Kanban swarm topology.

Install from Hermes with:

hermes skills tap add djm204/agent-workflow-skills
hermes skills install djm204/agent-workflow-skills/skills/codex-review-loop --yes
hermes skills install djm204/agent-workflow-skills/skills/resolve-issues --yes
hermes skills install djm204/agent-workflow-skills/skills/hermes-session-start --yes
hermes skills install djm204/agent-workflow-skills/skills/hermes-task-start --yes
hermes skills install djm204/agent-workflow-skills/skills/hermes-task-end --yes
hermes skills install djm204/agent-workflow-skills/skills/pm-swarm --yes

Antigravity / Gemini install

This repository also publishes Gemini/Antigravity-compatible skill packages under skills/:

Skill	Purpose
gemini-session-start	Start/recover Gemini sessions with compact project and work-state context.
gemini-task-start	Kick off non-trivial Gemini implementation tasks with the right planning/recovery path.
gemini-task-end	Run Gemini task completion quality gates before claiming done.
gemini-review-loop	Drive the GitHub chatgpt-codex-connector review loop until a PR is clean.

To install locally, copy the skill directories into your local configuration folder:

• Antigravity (TUI/IDE): ~/.gemini/config/skills/
• Gemini CLI: ~/.gemini/skills/

Releases

This repository uses Release Please for semantic-versioned GitHub releases from Conventional Commits. See docs/releasing.md.

Workflow Overview

Session Start (auto)

Every session: git state + memory index + WIP tasks + active lessons → compact brief injected via hook. No tool calls needed.

Task Start

• Spec provided → dive in, identify blast radius, plan, get approval
• "continue" → recovery: todo + git diff + memory → brief → confirm
• No spec → 7-question requirements interview → plan → ADR if needed → approval

Task End

Quality gates → docs updates → ADR → ramp-up doc → PR → Codex review loop. The loop prefers a codex-review-loop skill if installed (the codex-review plugin), and otherwise falls back to an inline 3× @codex review loop (address all threads each round).