Skip to content
cccskills
FreePublished on GitHub

beads

Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, or choose between local planning and persistent project tracking.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md2.1 KB
  • agents/openai.yaml175 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

  1. Find work:
bd ready
bd list --status=open
bd list --status=in_progress
  1. Inspect before editing:
bd show <id>
  1. Claim work atomically:
bd update <id> --claim
  1. Create durable follow-up work when implementation reveals new tasks:
bd create "Short title" --description="Why this exists and what needs to be done" --type=task --priority=2
  1. Close completed work:
bd close <id> --reason="Completed"

What Belongs In Beads

Use Beads for:

  • shared project tasks
  • blockers and dependencies
  • discovered follow-up work
  • work that must survive thread reset, compaction, or handoff
  • status that another person or agent should be able to resume

Use agent-local planning tools only for the current turn's execution checklist. Do not treat them as shared project state.

Rules

  • Do not create markdown TODO files as the source of truth when Beads is available.
  • Do not use bd edit; it opens an interactive editor. Use bd update flags instead.
  • Prefer --json when parsing bd output programmatically.
  • If hooks are installed, bd prime may already be injected. Run it manually when context is missing.
  • Do not auto-close or mutate tasks unless the work is actually complete.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

kb

Free

Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents. Use when adding content to a bundle, creating a new bundle, checking the knowledge base for conformance or provenance drift, building or querying its SQLite index, managing intent through its lifecycle, recording or reading architectural decisions as Decision Records, or navigating, searching and listing its bundles, concepts and links.

The English summary is being prepared. Showing the original description.

finos/morphir214Updated Oct 19, 2026

Use when adding, adopting, debugging or updating Morphir CLI examples and morphir itest scenarios, including scenarios.md, .feature.md and .feature files, scenario metadata, Rego assertions and integration coverage.

The English summary is being prepared. Showing the original description.

finos/morphir214Updated Oct 19, 2026

Use when asked to babysit or watch a PR, when watching an open pull request, after opening or pushing to a PR, or when asked to monitor CI, review comments, merge conflicts, whether a PR is ready to merge, or to trigger a re-review.

The English summary is being prepared. Showing the original description.

finos/morphir214Updated Oct 19, 2026

Assists with Morphir CLI release management for finos/morphir, including pre-release verification, extension verification, version bumps, tagging, and release coordination. Use when preparing releases, checking release readiness, or managing version bumps.

The English summary is being prepared. Showing the original description.

finos/morphir214Updated Oct 19, 2026

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

The English summary is being prepared. Showing the original description.

finos/morphir214Updated Oct 19, 2026

Assists with writing and maintaining Morphir technical documentation. Use when creating, reviewing, or updating documentation including API docs, user guides, tutorials, and content for the Docusaurus site. Also helps ensure documentation quality through link checking, structure validation, and code review for documentation coverage.

The English summary is being prepared. Showing the original description.

finos/morphir214Updated Oct 19, 2026

See all skills by finos

Report a problem with this skill