Workthreads

Deterministic weekly rollup of team work threads from .specstory coding histories.

Tested · Works

Test report

Verdict
Tested · Works
Score
9.6/10
Tested
Jul 20, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 213074d

Fetched workthreads/SKILL.md + all 6 lib scripts from the dev branch and ran the engine against the repo's own fixtures: `index` ingested 6 sessions across 2 projects, `threads` grouped them per-repo into New/Open/Recently-closed with exact path:line evidence, and correctly flagged the PAYMENT_RETRY thread as reverted:true from a git rollback. Self-contained (node:sqlite built-in, zero deps), git called only via execFileSync with fixed array args, and it ships deterministic secret-redaction (AWS/GitHub/Slack/OpenAI/Anthropic/JWT/bearer patterns) before any output — no network, no curl|sh, no exfiltration found; 11/11 bundled tests pass on Node 24.7.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 9/10
  • Docs & honesty 5/5

What Workthreads does

Runs a zero-dependency Node engine over a team's .specstory/history transcripts to cluster sessions into work threads per repo, label each new/open/closed with a reverted marker, and emit path:line evidence — then you synthesize the lead's weekly report. Triggers on "what happened this week", "what's still open", "give me the weekly rollup" over a coding-history corpus.

How to install Workthreads

Clone the repo, then `bash workthreads/install.sh` (copies the engine to ~/.agents/skills/workthreads and symlinks into ~/.claude/skills). Requires Node >=22.5 for the built-in node:sqlite. Zero npm dependencies.

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Workthreads

  • /workthreads Deterministic weekly rollup of team work threads from .specstory coding histories.

It also activates on plain-language prompts like these:

  • What happened on the team this week
  • Give me the weekly rollup across our repos
  • What is still open from last week's work

Frequently asked questions

Is the Workthreads skill free?
Yes. The skill itself is free from specstoryai/getspecstory. SkillProof publishes the install command and an independent test verdict at no cost.
Does Workthreads work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 20, 2026. Verdict: Tested · Works. Fetched workthreads/SKILL.md + all 6 lib scripts from the dev branch and ran the engine against the repo's own fixtures: `index` ingested 6 sessions across 2 projects, `threads` grouped them per-repo into New/Open/Recently-closed with exact path:line evidence, and correctly flagged the PAYMENT_RETRY thread as reverted:true from a git rollback. Self-contained (node:sqlite built-in, zero deps), git called only via execFileSync with fixed array args, and it ships deterministic secret-redaction (AWS/GitHub/Slack/OpenAI/Anthropic/JWT/bearer patterns) before any output — no network, no curl|sh, no exfiltration found; 11/11 bundled tests pass on Node 24.7.
What is the Workthreads SkillProof Score?
9.6/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 9/10, docs & honesty 5/5.
How do I install Workthreads?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Workthreads with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.