Agent skill
markdowntown-bd
Beads (bd) issue workflow and repo operations for markdowntown. Use when creating bd tasks, updating status, adding dependencies, running required tests, committing, and pushing to main.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/markdowntown-bd
SKILL.md
markdowntown-bd
Core workflow
- Clear stale work:
node scripts/bd-reset-stale.mjs --hours 4. - Pick work:
npx bd --no-daemon ready --json. - Claim task:
npx bd --no-daemon update <id> --status in_progress --json. - Read task:
npx bd --no-daemon show <id> --json. - Implement changes and run required tests.
- Commit and push to
mainafter tests pass. - Close task:
npx bd --no-daemon close <id> --reason "Implemented" --json. - Commit
.beads/issues.jsonlupdates with code changes. - At session end:
npx bd --no-daemon sync.
Guardrails
- Always use
--no-daemonand--jsonwith bd commands. - Never leave tasks in
in_progressif stopping work. - Always run compile, lint, and unit tests before committing.
- Push to
mainafter each completed task. - Avoid destructive git commands unless explicitly requested.
- Never paste secrets (tokens, keys, credentials) into issues, commits, or logs.
References
- docs/BEADS.md
- docs/DEV_ONBOARDING.md
- codex/skills/markdowntown-bd/references/beads.md
- codex/skills/markdowntown-bd/references/release.md
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?