Beads

by gastownhall

Beads is an AI Engineering skill for Claude Code, published by gastownhall in beads.

26.3K stars1.8K forkson gastownhall/beadsAdded 2026/08/14Repository updated 2026/08/13

View source on GitHub Download repo ZIP

agentsclaude-codecoding

Install in seconds

Install Beads

Copy Beads into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/gastownhall/beads/tree/main/internal/templates/skills/beads ~/.claude/skills/beads

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/gastownhall/beads.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: internal/templates/skills/beads/SKILL.md in gastownhall/beads
Installs to: ~/.claude/skills/beads
Collection: One of 3 skills cataloged from this repository
Category: AI Engineering — 2451 skills

What Beads does

Beads provides a durable, shared task-tracking workflow for repositories that use the bd CLI. Use it to find ready work, claim or close tasks, manage blockers, and preserve project context across sessions.

Beads is cataloged under AI Engineering on DirSkills. Beads comes from a repository tagged agents, claude-code and coding.

Documentation

README

Excerpt

Beads

Use Beads as the shared project task system. Local plans, scratch files, and personal memories are useful, but they are not the durable source of truth for project work.

First Step

Run:

bd prime

If that prints nothing, check whether the repository has an active Beads workspace:

bd where

Preferred Route

Use the bd CLI when shell access is available. It is the most compact and direct Beads interface.

Core CLI Workflow

Find work:

bd ready
bd list --status=open
bd list --status=in_progress

Inspect before editing:

bd show <id>

Claim work atomically:

bd update <id> --claim

Create durable follow-up work when implementation reveals new tasks:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Beads

What else does gastownhall publish alongside Beads?
Beads is one of 3 skills that DirSkills catalogs from gastownhall/beads, the repository it ships in. Its siblings there include Beads and Beads Documentation. Each one is a separate skill with its own page in this directory, installs the same way Beads does, and is maintained by gastownhall in that same repository. The rest of the collection is listed on the gastownhall/beads page.
How does Beads compare to other AI Engineering skills?
Beads ranks #213 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Beads against them. Open each page to compare what they document and how they install.