convez.ai
SkillAutomaçãoAvançado
joogy06

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 GitHub
InicialPluginScore · de 0 a 100

Coleçã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-foundry

1 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

Estrelas
5
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.md at the repo root alongside skills/ and agents/.


What's Inside

  • 159 skills — domain knowledge Claude loads on demand to help with specific tasks (including publish-to-github for releasing this whole tree to public github safely, visual-companion for browser-based mockup/diagram review during design, and cross-project-mail for 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-docs to 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.

StepWhat happens
1install.py places skills / agents / commands under ~/.claude/
2Places ~/.claude/CLAUDE.md (global instructions)
3Symlinks ~/.claude/AGENTS.md → CLAUDE.md (GitHub Copilot bridge)
4Mirrors pa-server/ into ~/.claude/pa-server/ (MCP server for the pa agent)
5Merges canonical SessionStart hooks into ~/.claude/settings.json (preserves any you already have; backs the old file up to .bak)
6Writes ~/.claude/policy-limits.json with conservative defaults, mode 0600
7Symlinks ~/.claude/bin/claude-observe for the process-observation skill
8Mirrors skills into ~/.codex/skills/* (only if codex CLI is on PATH)
9Pins Gemini model to gemini-3.1-pro-preview in ~/.gemini/settings.json (only if file exists)
10Prints 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.ps1 is enterprise-hardened — #Requires -Version 5.1, [CmdletBinding()] with named switch parameters, no -ExecutionPolicy Bypass, no dot-source, no -Command. Invoke with pwsh -NoProfile -NonInteractive -File bootstrap-environment.ps1.
  • The bootstrap script probes py (PEP-397 launcher) → python3 → python in that order and runs the orchestrator with whichever resolves first.
  • For backward compatibility, the older install.cmd / install.ps1 entry points are still present. They use -ExecutionPolicy Bypass for compatibility with very locked-down machines; prefer bootstrap-environment.ps1 on 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 — the AGENTS.md copy 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

TierWhat it gives youWhat to install
MinimalAll 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 reviewsAdd pa-server MCP (custom) + claude-in-chrome MCP

See docs/dependencies/ for complete install instructions.


The Agents

AgentPurposeRun standalone?
forgeDesign exploration with multi-model challengers (Claude + Codex + Gemini). Produces approved design docs.Yes
bobAutonomous implementation executor. Reads approved design docs, decomposes into work packages, delegates to team-based orchestration, verifies output.Yes (needs a design doc)
alfEvolution & improvement reviewer. Audits skills/agents/code/products for staleness, drift, capability gaps, security, performance. Produces evidence-cited reports.Yes
paTask router and persistent workspace manager. Classifies intent, routes to specialist agents, tracks state across sessions.Yes (stateless mode without pa-server MCP)
wikiKnowledge 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


Design Principles

Skills and agents in this repository follow these principles:

  1. Documentation-first — Most skills are reference material Claude reads on demand, not executable code
  2. Graceful degradation — Missing optional dependencies produce gap notes, never hard failures
  3. Evidence before assertions — Agents (especially alf) require sources, tiers, confidence levels for all external claims
  4. Model-agnostic language — Skills avoid Claude-specific constructs where possible; most work in Codex CLI and Gemini CLI too
  5. No secrets, no tokens — Skills reference environment variable names, never values. The pa agent explicitly refuses to store credentials
  6. Standalone-capable — Every agent can run without the others; the full graph is opt-in

Installation Matrix

InstallingYou getTime
Skills only150+ 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 sessionsBuild 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:

  1. Customize skills/ and agents/ for your needs
  2. Create ~/.claude/publish-config.json (template at skills/publish-to-github/templates/publish-config.example.json)
  3. Run python3 ~/.claude/skills/publish-to-github/scripts/publish_prep.py --extended-scan
  4. Inspect the staging dir, then git init / add / commit / push from there

See skills/publish-to-github/SKILL.md for the full workflow.


License

MIT


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.).

Ver o original no GitHub

Bom para

Relacionados