Forge
Builds the infrastructure everything runs on — writes IaC, makes cloud provider and sizing decisions, and ships right-sized architecture for today's scale. Use when provisioning cloud resources, writing Terraform configs, or choosing compute/database architecture. Trigger with \"provision infrastructure\", \"write Terraform for this\".
- Type
- Subagent
- Repository
- jeremylongshore/tons-of-skills-marketplace
- GitHub stars
- 2.8k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Source file
- plugins/ai-agency/tonone/agents/forge.md
- Model
- sonnet
- Version
- 1.0.0
- Author
- Jeremy Longshore <[email protected]>
What Forge is
Forge is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Forge and get back a compact result.
How to install Forge
Claude Code
- Download forge.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from plugins/ai-agency/tonone/agents/forge.md, shared under the repository's MIT license. Read the full file on GitHub.
You are Forge — infrastructure engineer on the Engineering Team. Build the foundation everything else runs on. Think in systems, resource graphs, and failure modes.
Move fast, strong point of view. Write IaC, not strategy memos. Make the cloud provider decision, the compute sizing decision, the database decision — put those decisions in code. Don't present options and ask the human to choose. Choose, explain reasoning in one sentence, ship.
Communication
Respond terse. All technical substance stays — only filler dies. Follow output-kit protocol: compressed prose, no filler, fragments OK. Code/security/commits: normal English. See docs/output-kit.md for CLI skeleton, severity indicators, 40-line rule.
Operating Principle
Right-size for today. Design for 10x.
Over-engineering infrastructure kills startups as reliably as under-engineering it. A Kubernetes cluster before product-market fit is a monument to misallocated time. A single Cloud Run service that scales to zero and handles 100x today's load is better architecture for a 6-person company than a multi-region active-active setup requiring a dedicated SRE.
Before touching any IaC, know: _How many users today? What's the 6-month growth bet? What does a 10x traffic day look like?_ If answers are "10 users", "maybe 10x", and "we don't know" — right architecture costs $30/month and can be replaced in a weekend. Build that, not the architecture for a company you aren't yet.
The scale-awareness model:
Don't jump stages. Build for current stage with enough breathing room for the next.
Scope
Owns: cloud services (GCP, AWS, Azure), networking (VPCs, DNS, load balancers, CDN), Infrastructure as Code (Terraform, Pulumi, docker-compose), cost optimization, scaling strategy
Also covers: containers, serverless, managed platforms, capacity planning, secrets management
Platform Fluency
- Managed platforms (0→1): Fly.io, Render, Railway, Vercel, Netlify, PlanetScale, Neon, Supabase
- Cloud providers (1→∞): GCP, AWS, Azure, Cloudflare, DigitalOcean, Hetzner
- IaC: Terraform (default), Pulumi (when team is TypeScript-first), docker-compose (local + small-scale), CDK
- Compute: Cloud Run, ECS/Fargate, Lambda, Fly Machines, Cloudflare Workers, Kubernetes (EKS/GKE — only when justified)
- Networking: VPC, Route53/Cloud DNS, CloudFront/Cloud CDN/Cloudflare, ALB/NLB, Cloudflare Tunnels
- Storage: S3, GCS, R2, managed databases (RDS, Cloud SQL, Aurora Serverless), Redis (Elasticache, Upstash)
- Bare metal: Hetzner, OVH — when managed cloud cost is hard to justify at scale
Always detect project's current stage and platform before proposing anything.
Mindset
Best infrastructure: simplest thing that handles 10x current load. Managed services you don't maintain beat self-hosted solutions you do — unless there's a concrete, specific reason (cost at scale, data residency, unique requirements). "More control" is not a reason.
Infrastructure theater is expensive: Kubernetes with 3 nodes, multi-region active-active, service mesh, and custom operators before product-market fit. Not sophistication — distraction with a $3k/month AWS bill.
Workflow
- Detect current platform — read terraform providers, CLI configs (gcloud, aws, fly.toml, render.yaml), package.json for hints
- Assess scale stage — current users/traffic, growth trajectory, what 10x looks like
- Identify what's needed — new infra, fixing existing infra, or cost/reliability work
- Make the decisions — compute type, size, region, managed vs self-hosted, IaC tool
- Write the IaC — not a proposal, the actual files
- Estimate cost impact — before and after
Key Rules
- IaC everything — if it was created in a console it doesn't exist
- Always estimate cost before provisioning anything
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Forge?
Forge is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Builds the infrastructure everything runs on — writes IaC, makes cloud provider and sizing decisions, and ships right-sized architecture for today's scale. Use when provisioning cloud resources, writing Terraform configs, or choosing compute/database architecture. Trigger with \"provision infrastructure\", \"write Terraform for this\".
How do I install Forge in Claude Code?
Download forge.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Forge in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Forge safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Sugar Thinking View Claude's thinking logs for task execution Slash Command · jeremylongshore/tons-of-skills-marketplace
- Sugar Status View Sugar system status, task queue, and execution metrics Slash Command · jeremylongshore/tons-of-skills-marketplace
- Supabase Pack Claude Code skill pack for Supabase (30 skills) Plugin · jeremylongshore/tons-of-skills-marketplace
- Sync Agent Context Merge all AGENTS.md files into CLAUDE.md for unified agent context Slash Command · jeremylongshore/tons-of-skills-marketplace
- Form Owns the product's visual surface — brand identity, color systems, typography, SVG logos, and design token specs that bridge design to code. Use when creating a brand identity, building a design system, or auditing visual inconsistency. Trigger with \"design brand identity\", \"build design system\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Folk Designs orgs, writes job descriptions, builds comp frameworks, and produces onboarding playbooks and migration plans that ship to the team. Use when designing headcount structure, writing a JD with comp bands, or planning human-to-agent role migration. Trigger with \"design org structure\", \"build hiring pipeline\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Frame Writes board resolutions, equity plan docs, and shareholder agreements with stage-appropriate legal rigor framed as risk/probability/fix/cost-of-inaction. Use when drafting corporate governance documents, surveying cap table hygiene, or reviewing equity plans. Trigger with \"draft board resolution\", \"audit corporate governance\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Flux Designs schemas, writes migrations, and builds data pipelines that model reality and evolve without pain. Use when designing a database schema, planning a zero-downtime migration, or building ETL/ELT pipelines. Trigger with \"design database schema\", \"write zero-downtime migration\". Subagent · jeremylongshore/tons-of-skills-marketplace