shep-aiOfficial·12 Agent Skills Included

cli

Run parallel coding agents in isolated worktrees to merge real PRs

Orchestrates parallel coding agents in isolated git worktrees, driving each feature from a one-line description through specs, implementation, commits, CI watching, and draft pull requests. Eliminates branch conflicts, manual worktree setup, and babysitting of long-running coding sessions. Includes spec-driven workflow skills, workstream planning, UI component standards, and diagramming guides to ship features faster with review gates.

241|51

↗

npx skills add shep-ai/cli --all -g -y

Available:

Instructs the agent on the mandatory spec-driven workflow, TDD cycles, TypeSpec-first modeling, and the shep-kit skill sequence to follow when building features in this repository.

All Skills in This Repository (12)

Pure Emerald Level Indicators

📦 In Repo

shep-ai

architecture-reviewer

Review TypeScript proposals for Clean Architecture layer boundaries and dependency direction.

mermaid-diagrams

Create and render Mermaid diagrams from text for software design documentation.

shep-kit:implement

Executes validated implementation tasks sequentially with automatic progress tracking and bounded retries.

shep-kit:commit-pr

Automate GitHub commits, PR creation, and CI verification loops.

shadcn-ui

Automate shadcn/ui component setup and usage in React projects.

cross-validate-artifacts

Cross-validate documentation and artifacts across codebase categories for consistency.

tsp-model

Generate TypeSpec domain models following project naming and structure conventions.

shep-kit:merged

Switch to the main branch, pull updates, and delete the merged feature branch.

shep-kit:plan

Generate plan.yaml and tasks.yaml from specs and research with gate checks.

shep-kit:new-feature

Generate a feature specification directory with YAML templates and Markdown artifacts.

vercel-react-best-practices

Apply React/Next.js performance best practices to reduce bundle sizes and eliminate waterfalls.

shep-kit:research

Generate research.yaml and Markdown documentation for feature implementation decisions.

Official

Advanced

Frequently Asked Questions

FAQPage Schema

How to install Shep CLI?▼

Run `npx skills add shep-ai/cli --all -g -y` in your terminal to install all skills in this suite globally.

How to run multiple coding agents in parallel?▼

Shep creates a separate git worktree and branch for each feature, then spawns an agent in each one. You monitor everything from the CLI or the web dashboard at localhost:4050.

Which coding agents does Shep support?▼

Claude Code, Cursor CLI, and Gemini CLI are built in, and any terminal-based agent CLI works through the generic executor. You can swap agents per feature or per repository.

Is my code safe when agents run autonomously?▼

Yes. Every feature runs in an isolated worktree, output lands as a draft PR, and your CI pipeline runs before any merge. Nothing merges without your approval unless you explicitly enable auto-merge.

What happens if an agent gets stuck or CI fails?▼

The agent reads CI failure logs and pushes fixes automatically with configurable retries. If it stays blocked, the feature enters a Blocked state and you can give feedback, resume it, or take over the branch directly.