Agent skill
feature-lifecycle
A suite of skills to manage the full development lifecycle from start to finish. - `start-feature`: Initializes a new feature branch, docs, and story. - `sync-feature`: Saves work with CI checks. - `finish-feature`: Verifies and creates a pull request.
Install this agent skill to your Project
npx add-skill https://github.com/stars-end/agent-skills/tree/master/feature-lifecycle
SKILL.md
Feature Lifecycle Skills
This file defines the three core skills for agent-driven development.
start-feature <issue-id>
Purpose: Initializes a new feature branch with all required scaffolding. Forces a "Test-First" mindset by creating the story skeleton.
Usage:
# From any product repo (affordabot, prime-radiant-ai)
feature-lifecycle/start.sh bd-123
BDD Spec:
- Given I am in a product repo
- And I provide a Beads issue ID
bd-123 - When I run
start-feature bd-123 - Then a new branch
feature-bd-123is created - And a doc file
docs/bd-123.mdis created - And a story file
docs/testing/stories/story-bd-123.ymlis created
sync-feature [options] <message>
Purpose: The "Save Button" for agents. Ensures all commits are clean by running ci-lite before saving. Prevents pushing broken code.
Usage:
# From a feature branch, commit valid work
feature-lifecycle/sync.sh "feat: add new login button"
# Force save broken work (e.g., to switch branches)
feature-lifecycle/sync.sh --wip "refactor: halfway through API change"
BDD Spec:
- Given I have syntax errors in my code
- When I run
sync-feature 'my commit' - Then the commit is BLOCKED and I receive an error to fix.
- But when I run
sync-feature --wip 'my commit' - Then the commit is created with a
[WIP]prefix.
finish-feature
Purpose: The "Handoff" to the QA/Merge phase. Runs the full PR verification suite before a PR is created, preventing review spam with broken code.
Usage:
# When a feature is complete and ready for review
feature-lifecycle/finish.sh
BDD Spec:
- Given I am on a feature branch
- And the
make verify-prtarget fails - When I run
finish-feature - Then the PR creation is BLOCKED and I am instructed to check the verification artifacts.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
toolchain-health
Validate Python toolchain alignment between mise, Poetry, and pyproject. Use when changing Python versions, editing pyproject.toml, or seeing Poetry/mise version solver errors. Invokes /toolchain-health to check: - .mise.toml python tool version - pyproject.toml python constraint - Poetry env python interpreter Keywords: python version, mise, poetry, toolchain, env use, lock, install
parallelize-cloud-work
Delegate independent work to Claude Code Web cloud sessions for parallel execution. Generates comprehensive session prompts with context exploration guidance, verifies Beads state, provides tracking commands. Use when user says "parallelize work to cloud", "start cloud sessions", or needs to execute multiple independent tasks simultaneously, or when user mentions cloud sessions, cloud prompts, delegate to cloud, Claude Code Web, generate session prompts, parallel execution, or asks "how do I use cloud sessions".
docs-create
Create epic-specific documentation skill with external reference docs. MUST BE USED for caching external docs. Fetches URLs, caches full content, uses documentation-engineer to generate cohesive summaries, and creates auto-activating skill. Use when starting work on epic that requires external documentation context (API docs, tool guides, reference materials), or when user mentions "cache docs", "external docs", "API documentation", URLs for docs, documentation needs, reference materials, knowledge caching, or epic context documentation.
railway-doctor
git-safety-guard
Installs a Git safety guard hook for Claude Code to prevent destructive Git and filesystem commands. Blocks accidental data loss from commands like 'git checkout --', 'git reset --hard', 'git clean -f', 'git push --force', and 'rm -rf'. Use this skill to set up safety rails in a new or existing repository, or globally for the agent.
beads-guard
Safe Beads workflow helper (warning-only). Use before bd sync/close/create to avoid JSONL conflicts. Ensures you are on a feature branch, up to date with origin/master, and stages Beads files cleanly with Feature-Key commits.
Didn't find tool you were looking for?