https://github.com/existential-birds/beagle
Claude Code plugin for code review skills and verification workflows. Python, Go, React, FastAPI, BubbleTea, and AI frameworks (Pydantic AI, LangGraph, Vercel AI SDK).
https://github.com/existential-birds/beagle
agent-skills ai-agents axum claude-code code-review developer-tools documentation elixir fastapi golang langgraph phoenix pydantic-ai python react rust swift swiftui tokio typescript
Last synced: 5 days ago
JSON representation
Claude Code plugin for code review skills and verification workflows. Python, Go, React, FastAPI, BubbleTea, and AI frameworks (Pydantic AI, LangGraph, Vercel AI SDK).
- Host: GitHub
- URL: https://github.com/existential-birds/beagle
- Owner: existential-birds
- License: apache-2.0
- Created: 2025-12-21T15:44:12.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-12T02:25:55.000Z (2 months ago)
- Last Synced: 2026-04-12T02:29:08.698Z (2 months ago)
- Topics: agent-skills, ai-agents, axum, claude-code, code-review, developer-tools, documentation, elixir, fastapi, golang, langgraph, phoenix, pydantic-ai, python, react, rust, swift, swiftui, tokio, typescript
- Language: Python
- Homepage: https://existentialbirds.com
- Size: 1.18 MB
- Stars: 46
- Watchers: 2
- Forks: 5
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# beagle
[](https://deepwiki.com/existential-birds/beagle)
*Image: NASA, Public Domain. [Source](https://www.nasa.gov/multimedia/imagegallery/image_feature_572.html)*
Beagle is a Claude Code plugin marketplace with 131 skills across code review, documentation, testing, architectural analysis, and git workflows. Use it to review before you push, detect AI-generated artifacts, draft and improve docs, generate test plans, and analyze codebases — across Python, Go, Rust, Elixir, React, Remix v2, iOS/Swift, and AI frameworks.
Used with [Amelia](https://github.com/existential-birds/amelia) for agent-based workflows and [Daydream](https://github.com/existential-birds/daydream) for automated review-fix-test loops.
## Installation
**Prerequisites:**
- [Claude Code](https://claude.ai/code) CLI installed
- [agent-browser](https://github.com/vercel-labs/agent-browser) for the `run-test-plan` skill (optional)
```bash
# Add the marketplace
claude plugin marketplace add https://github.com/existential-birds/beagle
# Install the plugins you need
claude plugin install beagle-core@existential-birds
claude plugin install beagle-python@existential-birds
claude plugin install beagle-react@existential-birds
```
Verify installation by opening a new Claude Code session and running `/beagle-core:commit-push` — if the skill loads, the plugin is active.
To update:
```bash
claude plugin marketplace update existential-birds && claude plugin update
```
**Troubleshooting:**
- "Marketplace file not found": Remove stale entries from `~/.claude/plugins/known_marketplaces.json` and restart Claude Code.
- Plugin not updating: Run `claude plugin marketplace update existential-birds` to refresh the marketplace.
### Other Agents
Use the [skills CLI](https://skills.sh/docs/cli) to install beagle skills for other AI agents:
```bash
npx skills add existential-birds/beagle
```
This downloads the skills and configures them for your agent.
**Codex users:** Link each plugin into `~/.agents/skills/` — see [.codex/INSTALL.md](.codex/INSTALL.md) for setup instructions.
## Plugins
| Plugin | Skills | Category |
|--------|--------|----------|
| **beagle-core** | 19 | Shared workflows, verification, git, skill tooling |
| **beagle-python** | 7 | Python, FastAPI, SQLAlchemy, pytest |
| **beagle-go** | 13 | Go, BubbleTea, Wish SSH, Prometheus |
| **beagle-elixir** | 11 | Elixir, Phoenix, LiveView, ExUnit, ExDoc |
| **beagle-ios** | 16 | Swift, SwiftUI, SwiftData, iOS frameworks |
| **beagle-react** | 28 | React, React Flow, shadcn/ui, Tailwind, Remix v2 |
| **beagle-rust** | 12 | Rust, tokio, axum, sqlx, serde |
| **beagle-docs** | 10 | Documentation quality, AI writing detection (Diataxis) |
| **beagle-analysis** | 13 | Brainstorming, ADRs, strategy, LLM-as-judge, spec gap resolution, TDD plan writing |
| **beagle-testing** | 2 | Test plan generation and execution |
| **Total** | **131** | — |
## Skills
These are the canonical skill entry points for Beagle.
### beagle-core
| Skill | Description |
|---------|-------------|
| `review-plan ` | Review implementation plans |
| `review-llm-artifacts` | Detect LLM coding artifacts |
| `verify-llm-artifacts` | Confirm or reject review findings before deletes |
| `fix-llm-artifacts` | Fix detected artifacts |
| `commit-push` | Commit and push changes |
| `create-pr` | Create PR with template |
| `gen-release-notes ` | Generate release notes |
| `receive-feedback ` | Process review feedback |
| `fetch-pr-feedback` | Fetch bot comments from PR |
| `respond-pr-feedback` | Reply to bot comments |
| `subagent-prompt` | Hand off the current session as an orchestrator-plus-subagents prompt for a fresh session |
| `prompt-improver` | Optimize prompts |
### Code Review Skills
| Skill | Plugin | Description |
|---------|--------|-------------|
| `review-python` | beagle-python | Python/FastAPI code review |
| `review-frontend` | beagle-react | React/TypeScript code review |
| `review-go` | beagle-go | Go code review |
| `review-tui` | beagle-go | BubbleTea TUI code review |
| `review-ios` | beagle-ios | iOS/SwiftUI code review |
| `review-elixir` | beagle-elixir | Elixir/Phoenix code review |
| `review-rust` | beagle-rust | Rust/tokio/axum code review |
| `review-remix-v2` | beagle-react | Remix v2 code review (loaders, actions, forms, sessions) |
### Documentation & Analysis Skills
| Skill | Plugin | Description |
|---------|--------|-------------|
| `draft-docs ` | beagle-docs | Generate documentation drafts |
| `improve-doc ` | beagle-docs | Improve docs using Diataxis |
| `ensure-docs` | beagle-docs | Documentation coverage check |
| `review-ai-writing` | beagle-docs | Detect AI writing patterns |
| `humanize-beagle` | beagle-docs | Fix AI writing with safe/risky classification |
| `llm-judge` | beagle-analysis | Compare implementations |
| `write-adr` | beagle-analysis | Generate ADRs from decisions |
| `brainstorm-beagle` | beagle-analysis | Turn fuzzy ideas into structured project specs |
| `resolve-beagle` | beagle-analysis | Close Open Questions and latent gaps in a brainstorm-beagle spec |
| `strategy-interview` | beagle-analysis | Build strategy through guided conversation |
| `strategy-review` | beagle-analysis | Pressure-test existing strategy documents |
| `prfaq-beagle` | beagle-analysis | Working Backwards PRFAQ filter — pass/fail concepts before brainstorming |
| `web-research` | beagle-analysis | Parallel-subagent web research with cited synthesis report |
| `artifact-analysis` | beagle-analysis | Parallel-subagent scan of local docs with cited extraction |
| `write-plan` | beagle-analysis | Turn a finalized `brainstorm-beagle` spec into a TDD-driven implementation plan |
### Skill Tooling
| Skill | Plugin | Description |
|---------|--------|-------------|
| `skill-builder` | beagle-core | Create new Claude Code skills with best practices |
| `review-skill` | beagle-core | Automated skill PR review for structural validity, design quality, and marketplace consistency |
### Testing Skills
| Skill | Plugin | Description |
|---------|--------|-------------|
| `gen-test-plan` | beagle-testing | Generate YAML test plan |
| `run-test-plan` | beagle-testing | Execute test plan |