CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bd-issue-tracking

Track complex, multi-session work with dependency graphs using bd (beads) issue tracker. Use when work spans multiple sessions, has complex dependencies, or requires persistent context across compaction cycles. For simple single-session linear tasks, TodoWrite remains appropriate.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills_all/bd-issue-tracking/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable commands, checklists, and concrete examples, and its workflows are well-sequenced with self-check validation. Its weaknesses are redundant coverage of the bd-vs-TodoWrite decision, a body length that retains detail belonging in reference files, and a progressive-disclosure architecture whose six referenced files are missing from the bundle.

Suggestions

Consolidate the three overlapping bd-vs-TodoWrite decision sections ("When to Use", "Test Yourself", and "Integration with TodoWrite") into one section and defer detail to references/BOUNDARIES.md to cut significant tokens.

Ship the six referenced references/*.md files in the skill bundle (BOUNDARIES.md, CLI_REFERENCE.md, WORKFLOWS.md, DEPENDENCIES.md, ISSUE_CREATION.md, STATIC_DATA.md) or remove the links, since every reference currently points to a non-existent file.

De-duplicate the database auto-discovery rules stated in both "Session Start Protocol" and "Database Selection", and re-order the Issue Lifecycle so Planning precedes Execution.

DimensionReasoningScore

Conciseness

The bd-vs-TodoWrite decision is covered three separate times ("When to Use bd vs TodoWrite", "Test Yourself: bd or TodoWrite?", and "Integration with TodoWrite"), and the database auto-discovery rules ("Uses .beads/*.db in current project if exists / Falls back to ~/.beads/default.db") are stated twice in nearly identical wording. Mostly efficient and free of explanations of concepts Claude already knows, but clearly could be tightened, matching anchor 3 rather than 2 since the padding is redundancy rather than patronizing explanation.

3 / 5

Actionability

Commands are copy-paste ready and cover the common cases: `bd create "Add OAuth" -p 0 -t feature`, `bd update issue-123 --status in_progress`, `bd dep add auth-epic auth-setup --type parent-child`, `bd close issue-1 issue-2 issue-3 --reason "..."`. Concrete good/bad note examples, copy-able checklists, report formats, and troubleshooting workarounds (e.g., `bd list | grep -i "search term"`) match anchor 5's fully executable, common-case-covering guidance.

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with checklists (Session Start Checklist, Progress Checkpoint, Issue Creation Checklist) and self-check validation ("Test yourself: If compaction happened right now, could future-me resume from these notes?"), plus conditional recovery paths ("If bd ready returns empty but issues exist: bd blocked --json" and a Troubleshooting section). Minor gaps keep it at anchor 4 rather than 5: the Issue Lifecycle numbers Planning (3) after Execution (2), and bulk operations like `bd close issue-1 issue-2 issue-3` have no verification step before closing.

4 / 5

Progressive Disclosure

References are clearly signaled and one level deep with a useful "Read When" table, but the six referenced files (references/BOUNDARIES.md, CLI_REFERENCE.md, WORKFLOWS.md, DEPENDENCIES.md, ISSUE_CREATION.md, STATIC_DATA.md) do not exist in the skill's bundle, so the disclosure structure does not actually resolve and navigation breaks. Additionally, the ~640-line body retains substantial material (TodoWrite integration patterns, full pattern walkthroughs, decision criteria repeated three times) that the reference files are meant to hold, fitting anchor 3 ("content that should be separate is inline") despite the good signaling.

3 / 5

Total

15

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly and explicitly states both what the skill does and when to use it, with concrete trigger phrases and an explicit disambiguation against TodoWrite. Its main weakness is limited enumeration of concrete capabilities beyond tracking and dependency graphs, and a few missing natural synonyms.

Suggestions

Add 1-2 more concrete capabilities to the first sentence (e.g., creating and linking issues, or capturing session-handoff notes that survive context compaction) to raise specificity.

Include one or two natural user phrasings as triggers, such as "task tracking across sessions" or "resume work after a break", to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Track complex, multi-session work with dependency graphs" names the domain (issue tracking) and 1-2 concrete actions (tracking work, managing dependency graphs), but does not enumerate further capabilities such as creating issues, capturing handoff notes, or resuming work. This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") rather than 4, which requires several specific actions listed.

3 / 5

Completeness

The what is explicit ("Track complex, multi-session work with dependency graphs using bd (beads) issue tracker") and the when is explicit with three concrete triggers ("Use when work spans multiple sessions, has complex dependencies, or requires persistent context across compaction cycles"), plus a negative boundary ("For simple single-session linear tasks, TodoWrite remains appropriate"). This clearly matches anchor 5 (both what and when with concrete trigger phrases); anchor 4 would require the when to be less explicit.

5 / 5

Trigger Term Quality

Natural phrases like "work spans multiple sessions", "complex dependencies", "persistent context", and "compaction cycles" give good keyword coverage of what a user would say, and "bd (beads)" names the tool. A few natural synonyms are missing (e.g., "task tracking", "resume work", "project memory"), which fits anchor 4 ("Good keyword coverage; a few natural terms missing") rather than 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The tool name "bd (beads)" and the multi-session/compaction triggers carve out a clear niche, and the explicit TodoWrite boundary ("For simple single-session linear tasks, TodoWrite remains appropriate") defuses the closest competing skill. Minor overlap risk remains with generic task- or issue-tracking requests, fitting anchor 4 ("Mostly distinct; minor overlap risk") rather than 5's minimal conflict risk.

4 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (645 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 19 missing

Warning

referenced_paths_exist

Referenced path issues: 37 missing

Warning

Total

13

/

16

Passed

Repository

Microck/ordinary-claude-skills

Path

skills_all/bd-issue-tracking/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.