Agent Foundry — Skills e Agentes para Claude Code
joogy06/agent-foundry
159 skills + 4 agentes + orquestração multi-modelo para fluxo AI coding completo
Ver no GitHubColeção de 141+ skills e 5 agentes especializados para o Claude Code CLI, cobrindo engenharia de software, DevOps, data engineering e orquestração de workflows. Inclui descoberta automática de skills, agentes nomeados para design/execução/revisão e comandos slash personalizados.
Instalação
npx convez-ai joogy06/agent-foundry1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de tarefas repetitivas em projetos Python/DevOps
- Orquestração de workflows com múltiplos modelos de IA (Claude, Gemini, Codex)
- Gerenciamento de conhecimento e políticas de segurança em repositórios
Veredito

Ferramenta robusta e madura para quem trabalha com Claude Code CLI em fluxos complexos. Exige familiaridade com linha de comando e estrutura de projetos Python; o bootstrap é bem documentado, mas o setup é denso. Ideal para equipes de engenharia que precisam padronizar workflows de IA.
README
A tradução para o português deste README ainda está na fila.
Claude Code Skills & Agents
A curated collection of skills and agents for Claude Code CLI, covering software engineering, DevOps, data engineering, infrastructure administration, and workflow orchestration.
About this file: This is a template for the public repository root README. When you create the GitHub repo, rename this file to
README.mdat the repo root alongsideskills/andagents/.
What's Inside
- 159 skills — domain knowledge Claude loads on demand to help with specific tasks (including
publish-to-githubfor releasing this whole tree to public github safely,visual-companionfor browser-based mockup/diagram review during design, andcross-project-mailfor AI-agent messaging across sibling projects on one host) - 4 agents — specialized sub-agents for design, execution, review, and knowledge management
- Slash commands — short user-invoked workflows under
~/.claude/commands/(e.g./exit-with-docsto wrap up a session and update project docs)
Skills are auto-discovered by Claude Code from frontmatter descriptions — you don't call them explicitly. Agents are invoked by name (forge, bob, alf, pa, wiki). Commands are invoked with a leading slash (e.g. /exit-with-docs).
Quick Start
# 1. Clone the repo
git clone https://github.com/<your-username>/<repo-name>.git
cd <repo-name>
# 2. Bootstrap a full environment (recommended for first-time setup)
python3 bootstrap-environment.py
# or, on Windows: pwsh -NoProfile -NonInteractive -File bootstrap-environment.ps1
The bootstrap orchestrator runs install.py plus 9 idempotent post-install steps so a fresh machine reaches a complete Claude Code environment in one command. Re-run any time — every step skips work already done.
| Step | What happens |
|---|---|
| 1 | install.py places skills / agents / commands under ~/.claude/ |
| 2 | Places ~/.claude/CLAUDE.md (global instructions) |
| 3 | Symlinks ~/.claude/AGENTS.md → CLAUDE.md (GitHub Copilot bridge) |
| 4 | Mirrors pa-server/ into ~/.claude/pa-server/ (MCP server for the pa agent) |
| 5 | Merges canonical SessionStart hooks into ~/.claude/settings.json (preserves any you already have; backs the old file up to .bak) |
| 6 | Writes ~/.claude/policy-limits.json with conservative defaults, mode 0600 |
| 7 | Symlinks ~/.claude/bin/claude-observe for the process-observation skill |
| 8 | Mirrors skills into ~/.codex/skills/* (only if codex CLI is on PATH) |
| 9 | Pins Gemini model to gemini-3.1-pro-preview in ~/.gemini/settings.json (only if file exists) |
| 10 | Prints next-step guidance |
After bootstrap, two more steps inside Claude Code finish the setup:
# Inside Claude Code:
/setup # interactive permissions upgrade
# (conservative -> autonomous)
# Per working repo you care about:
bash scripts/install-pre-push-hook.sh /path/to/repo # POSIX
# or any OS (incl. enterprise Windows where PowerShell is blocked):
python3 scripts/install-pre-push-hook.py --target-repo /path/to/repo
The pre-push hook runs a secrets scanner (live API keys, PEM private keys, AWS credentials, JWTs, inline tokens, etc.) before every git push. Critical/high findings block the push; medium/low advisory hits print but don't block. Override per-push with git push --no-verify.
Bootstrap flags
python3 bootstrap-environment.py --dry-run # preview without writing
python3 bootstrap-environment.py --force # overwrite existing CLAUDE.md / pa-server / policy-limits
python3 bootstrap-environment.py --skip-install # don't run install.py
python3 bootstrap-environment.py --skip-codex # don't touch ~/.codex/
python3 bootstrap-environment.py --skip-gemini # don't touch ~/.gemini/settings.json
python3 bootstrap-environment.py --claude-home /opt/claude # custom config root
python3 bootstrap-environment.py --help
Minimal install (skills + agents + commands only)
If you already have a CLAUDE.md, hooks, and other host config and just want the skill content placed:
python3 install.py # interactive
python3 install.py --noninteractive # Claude + link
python3 install.py --target claude,gemini --mode link
python3 install.py --target all --mode move --force # full copy, overwrite
python3 install.py --claude-home /opt/claude # custom path
python3 install.py --help # all flags
install.py is what bootstrap-environment.py calls under the hood for step 1, so the flags are pass-through-able via --install-arg.
Windows enterprise notes
bootstrap-environment.ps1is enterprise-hardened —#Requires -Version 5.1,[CmdletBinding()]with named switch parameters, no-ExecutionPolicy Bypass, no dot-source, no-Command. Invoke withpwsh -NoProfile -NonInteractive -File bootstrap-environment.ps1.- The bootstrap script probes
py(PEP-397 launcher) →python3→pythonin that order and runs the orchestrator with whichever resolves first. - For backward compatibility, the older
install.cmd/install.ps1entry points are still present. They use-ExecutionPolicy Bypassfor compatibility with very locked-down machines; preferbootstrap-environment.ps1on modern setups. - Symbolic links on Windows require admin or Developer Mode. If symlinks fail, the bootstrap falls back to copy and prints a warning (drift risk if you later edit
CLAUDE.md— theAGENTS.mdcopy won't update).
Manual install (alternative)
If you'd rather not run a script:
cp -r skills/* ~/.claude/skills/
cp -r agents/*.md ~/.claude/agents/
cp -r commands/*.md ~/.claude/commands/
cp CLAUDE.md ~/.claude/CLAUDE.md
ln -s ~/.claude/CLAUDE.md ~/.claude/AGENTS.md
cp -r pa-server ~/.claude/pa-server
You'll then need to add the SessionStart hooks to ~/.claude/settings.json by hand — see the bootstrap script's source for the canonical entries. For the full multi-model experience with Codex and Gemini as second-opinion models, see Dependencies.
What You Need
| Tier | What it gives you | What to install |
|---|---|---|
| Minimal | All 150+ domain skills work as Claude reference material. wiki agent works fully. | Claude Code CLI only |
| Standard | + forge / bob / alf agents with multi-model reviews (Codex + Gemini) | Add Codex CLI + Codex plugin + Gemini CLI MCP |
| Full | + pa agent with persistent task tracking, browser-based product reviews | Add pa-server MCP (custom) + claude-in-chrome MCP |
See docs/dependencies/ for complete install instructions.
The Agents
| Agent | Purpose | Run standalone? |
|---|---|---|
| forge | Design exploration with multi-model challengers (Claude + Codex + Gemini). Produces approved design docs. | Yes |
| bob | Autonomous implementation executor. Reads approved design docs, decomposes into work packages, delegates to team-based orchestration, verifies output. | Yes (needs a design doc) |
| alf | Evolution & improvement reviewer. Audits skills/agents/code/products for staleness, drift, capability gaps, security, performance. Produces evidence-cited reports. | Yes |
| pa | Task router and persistent workspace manager. Classifies intent, routes to specialist agents, tracks state across sessions. | Yes (stateless mode without pa-server MCP) |
| wiki | Knowledge base builder. Ingests sources into cited, interlinked markdown wiki pages. Compile-once, read-cheaply model. | Yes (no external dependencies) |
Architecture: pa routes → forge designs → bob implements → alf reviews → all can query wiki. See Agent Graph for the full interaction diagram.
Skill Categories
forge · agent-teams · team-manager · challenger · qa-reviewer · ux-reviewer · research-for-skills · codex-orchestration · web-research · development-lifecycle · project-documentation · simplify · publish-to-github · visual-companion
Build and manage agent teams, run multi-model reviews, decompose work.
wiki · obsidian · large-file-analysis · confluence-documentation · confluence-content-creator · confluence-rest-api · research-vectorization
Persistent knowledge bases, large document analysis, Confluence integration, vector search.
python-flask-developer · python-auth-security · python-parallelism · python-data-engineer · python-enterprise-connectors
Flask, auth/OAuth/OIDC, asyncio/multiprocessing, SQLAlchemy, enterprise database connectors.
content-writer · plus JS/TS patterns from upstream plugins
Frontend design, content creation, modern web frameworks.
java-backend · java-frontend
Spring Boot, Spring Security, Spring Data JPA, Angular 17+, React 18+, NgRx/Redux.
docker-fundamentals · docker-networking · docker-storage · docker-security · docker-cicd · docker-compose-patterns · docker-admin
Container lifecycle, networking, volumes, security hardening, CI/CD, multi-stage builds.
rhel-server-admin · rhel-web-servers · rhel-databases · rhel-docker-host · rhel-file-storage · rhel-network-infra · rhel-monitoring · rhel-ollama-nvidia
Full RHEL 9 administration stack including NVIDIA/CUDA/Ollama for AI workloads.
ubuntu-server-admin · ubuntu-web-servers · ubuntu-databases · ubuntu-docker-host · ubuntu-file-storage · ubuntu-network-infra · ubuntu-monitoring · ubuntu-ollama-nvidia
Full Ubuntu 24.04 administration stack, parallel to the RHEL set.
linux-centrify
Centrify/Delinea Server Suite, Active Directory integration, PAM/NSS.
windows-powershell · windows-cmd · windows-ps-server-admin · windows-ps-security · windows-ad-admin · windows-sso
PowerShell 7.x + 5.1, batch scripting, AD administration, security hardening, SSO (AD FS, Azure AD, SAML/OAuth/OIDC).
mongodb · db2-rhel · db2-mainframe
MongoDB (replica sets, sharding), DB2 LUW on RHEL, DB2 for z/OS mainframe.
ibm-mainframe · cobol-developer · db2-mainframe · ibm-mq · ibm-websphere · cognos-admin · cognos-user · datastage-developer · pega-robotics · control-m
z/OS, JCL, COBOL, DB2 z/OS, IBM MQ, WebSphere, Cognos Analytics, DataStage, Pega RPA, Control-M workload automation.
data-lake · data-warehouse · data-mart · datastage-developer · market-data-engineering · research-vectorization
Lakes (Parquet/Iceberg/Delta), warehouses (Kimball/Inmon), marts (star/snowflake), ETL with DataStage, financial data pipelines.
saas-architecture · saas-developer
Multi-tenant patterns, subscription billing, onboarding flows, tenant isolation, feature flags.
trading-strategy-backtester · trading-risk-management · crypto-exchange-integration · day-trading-patterns · financial-sentiment-analysis · geopolitical-market-impact · social-trading-signals · market-data-engineering · trader-psychology-analysis
Backtesting with vectorbt/backtrader, kill switches, CCXT, intraday patterns, FinBERT sentiment, event-driven signals.
seo-content-strategist · seo-keyword-strategist · seo-structure-architect · seo-meta-optimizer · seo-serp-optimizer · seo-authority-builder · seo-data-analyst · ai-search-optimizer · conversion-psychology · ecommerce-growth
Full SEO stack including AI search optimization (ChatGPT/Gemini/Perplexity citations), schema markup, topic clusters, GSC/GA4 analytics.
wordpress-developer · wordpress-admin · woocommerce-developer · hostinger-hosting
Theme/plugin development, block editor, WooCommerce checkout, hosting-specific patterns.
career-coach · career-assessment · career-planning · career-positioning · career-leadership · career-storytelling · career-transition
Career strategy, self-assessment, interview prep, promotion cases, leadership development.
presentation-builder · presentation-narrative · presentation-datavis · presentation-diagrams · presentation-styling · presentation-renderer
Orchestrated presentation creation — narrative frameworks, charts, diagrams, styling, PPTX/HTML export.
project-manager · delivery-manager · project-finance · jira-rest-api
WBS, critical path, EVM, Agile ceremonies, flow metrics, Jira integration.
jenkins · ansible · docker-cicd · gcp-workstations
Pipeline development, infrastructure as code, CI/CD Docker builds, cloud dev environments.
splunk-developer · rhel-monitoring · ubuntu-monitoring
SPL queries, dashboards, Prometheus/Grafana/Loki, ELK stack, alerting.
claude-code-cli · gemini-cli · gh-copilot-cli · codex-orchestration · mcp-server-creator
Claude Code CLI reference, Gemini CLI, GitHub Copilot CLI, Codex delegation, building MCP servers.
nano-banana · vertex-banana
Image generation via Gemini API (primary) and Vertex AI (fallback).
performance
Profiling, load testing, query optimization, bottleneck analysis.
Documentation
- docs/dependencies/README.md — install tiers, component matrix, quick start
- docs/dependencies/local-tools.md — Claude Code CLI, Codex CLI, Gemini CLI, plugins, environment variables
- docs/dependencies/mcp-servers.md — Gemini CLI MCP, claude-in-chrome MCP, pa-server MCP
- docs/dependencies/agent-graph.md — how agents interconnect, data contracts, minimal subsets
- feedback-loop.md — known compatibility issues + reporting template. Read this first if you're installing on Windows / macOS / WSL / a container / an air-gapped host — this collection was developed on a single Linux host and your environment may behave differently. Your bug report becomes the next user's starting point.
Design Principles
Skills and agents in this repository follow these principles:
- Documentation-first — Most skills are reference material Claude reads on demand, not executable code
- Graceful degradation — Missing optional dependencies produce gap notes, never hard failures
- Evidence before assertions — Agents (especially
alf) require sources, tiers, confidence levels for all external claims - Model-agnostic language — Skills avoid Claude-specific constructs where possible; most work in Codex CLI and Gemini CLI too
- No secrets, no tokens — Skills reference environment variable names, never values. The
paagent explicitly refuses to store credentials - Standalone-capable — Every agent can run without the others; the full graph is opt-in
Installation Matrix
| Installing | You get | Time |
|---|---|---|
| Skills only | 150+ domain knowledge modules | <1 min |
| Skills + agents | + forge/bob/alf/wiki/pa orchestration | <2 min |
| + Codex CLI + plugin | + GPT-5.4 challenger reviews | ~10 min (Codex auth) |
| + Gemini CLI + MCP | + Gemini 3 third-model verification, 1M-context analysis | ~10 min (Gemini auth) |
| + claude-in-chrome | + browser-based product reviews for alf | ~15 min (Chrome extension) |
| + pa-server (custom) | + persistent task tracking across sessions | Build your own |
Contributing
Contribution guidelines — to be added.
Publishing your own copy
The publish-to-github skill in skills/publish-to-github/ is itself the workflow that produced this repo. It scrubs private content, runs security checks, and produces a clean staging directory. To publish your own modified copy:
- Customize
skills/andagents/for your needs - Create
~/.claude/publish-config.json(template atskills/publish-to-github/templates/publish-config.example.json) - Run
python3 ~/.claude/skills/publish-to-github/scripts/publish_prep.py --extended-scan - Inspect the staging dir, then
git init / add / commit / pushfrom there
See skills/publish-to-github/SKILL.md for the full workflow.
License
Disclaimer
This repository is a collection of prompts, documentation, and configuration designed to work with Claude Code CLI. It does not contain executable programs (beyond small helper scripts in some skills). Running the skills and agents requires Claude Code CLI and, for the full experience, additional third-party tools documented in docs/dependencies/.
The skills encode how to perform tasks — Claude reads them and acts on your behalf. You are responsible for reviewing Claude's actions before confirming destructive operations (deletes, force pushes, production deploys, etc.).