Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@
},
"plugins": [
{
"name": "workbench",
"name": "fathom",
"source": "./",
"description": "Two agent skills, scaffold and execute, that carry a tracker issue from requirements to an open code review, on GitHub or any other forge with an adapter. Works with Asana or Linear, runs on Claude Code and Kiro, tracks tasks in beads or a committed markdown checklist, and resumes from repository state.",
"version": "1.1.0",
"version": "2.0.0",
"author": {
"name": "crod951"
},
Expand Down
6 changes: 3 additions & 3 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "workbench",
"version": "1.1.0",
"description": "Workbench provides the execute and scaffold skills for driving Asana or Linear tracker issues from requirements to an open code review, on GitHub or any other forge with an adapter. Agent-portable skills for Claude Code and Kiro with resumable, task-tracked implementation runs.",
"name": "fathom",
"version": "2.0.0",
"description": "Fathom provides the execute and scaffold skills for driving Asana or Linear tracker issues from requirements to an open code review, on GitHub or any other forge with an adapter. Agent-portable skills for Claude Code and Kiro with resumable, task-tracked implementation runs.",
"author": {
"name": "crod951",
"email": "crod951@gmail.com"
Expand Down
2 changes: 1 addition & 1 deletion .skillspector-baseline.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ rules:
adding that phrase to a skill, re-review whether the suppression still
only hides benign uses.

# workbench-shared carries the contract files execute and scaffold read;
# fathom-shared carries the contract files execute and scaffold read;
# its SKILL.md exists so directory-copying installers (npx skills) bring it
# along. Scanning it flags documentation text, not executable skill behavior.

Expand Down
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ All skills are scanned with [NVIDIA SkillSpector](https://github.com/NVIDIA/Skil

```text
/plugin marketplace add crod951/skills
/plugin install workbench@crod951
/plugin install fathom@crod951
```

**Kiro, Codex, and other agents** - use [skills.sh](https://www.skills.sh) for an editable copy on any agent:
Expand All @@ -20,27 +20,27 @@ All skills are scanned with [NVIDIA SkillSpector](https://github.com/NVIDIA/Skil
npx skills@latest add crod951/skills
```

When the installer asks which skills to take, take all of them; `workbench-shared` carries the contract files the other two read.
When the installer asks which skills to take, take all of them; `fathom-shared` carries the contract files the other two read.

> Individual plugins may have additional prerequisites that run in your **terminal** (e.g., `brew install`). See each plugin's README for details.

## Available Plugins

### workbench (v1.1.0)
### fathom (v2.0.0)

Workbench provides two agent skills, execute and scaffold, that carry a tracker issue from requirements to an open code review, on GitHub or any other forge with an adapter.
Fathom provides two agent skills, execute and scaffold, that carry a tracker issue from requirements to an open code review, on GitHub or any other forge with an adapter.
It works with Asana or Linear as your issue tracker, and both skills run unchanged on Claude Code and Kiro.

#### Prerequisites

- An Asana or Linear MCP plugin installed and authenticated
- [Beads CLI](https://github.com/gastownhall/beads) installed (`bd` command available); optional, but recommended for the richest task memory
- A forge adapter for wherever your reviews live. Two ship built in: GitHub, which needs the [GitHub CLI](https://cli.github.com/) installed and authenticated (`gh` command available), and a generic-git fallback that pushes the branch and hands the review off to you. Write a `.workbench/forge.md` from the bundled template only for a forge workbench does not ship.
- A forge adapter for wherever your reviews live. Two ship built in: GitHub, which needs the [GitHub CLI](https://cli.github.com/) installed and authenticated (`gh` command available), and a generic-git fallback that pushes the branch and hands the review off to you. Write a `.fathom/forge.md` from the bundled template only for a forge Fathom does not ship.

#### Install

```bash
/plugin install workbench@crod951
/plugin install fathom@crod951
```

#### Skills
Expand All @@ -65,15 +65,15 @@ scaffold these requirements
- **Task memory** - beads-backed when available, with a plain checklist file fallback
- **Conventional Commits** - one commit per task, referencing the issue ref
- **Tracker-only access** - tracker work only happens through the connected tracker MCP; when it is missing, the skill refuses and stops
- **Forge-portable** - reviews go through a five-operation forge contract; GitHub and a generic-git fallback ship built in, and any other forge is a `.workbench/forge.md` you write without forking
- **Forge-portable** - reviews go through a five-operation forge contract; GitHub and a generic-git fallback ship built in, and any other forge is a `.fathom/forge.md` you write without forking

#### Tracker Status Lifecycle

```text
Todo → In Progress (execute starts) → In Review (review opened) → Done (review merged)
```

See the [full guide](./docs/workbench.md) for setup, task memory, and the security boundary.
See the [full guide](./docs/fathom.md) for setup, task memory, and the security boundary.

---

Expand Down
Loading
Loading