Who Forge is for
Forge isn't just for developers. The SKILL.md format makes the agent a document — and three audiences collaborate through that document to build, extend, and operate production agents.
The agent runtime market is dominated by products that assume the agent is code. Pick a Python framework, learn its abstractions, write the orchestration, manage the dependencies, deploy the container. That model works for one audience: software engineers. It excludes the people who actually know what the agent should do — the SREs who write the runbooks, the security engineers who document the controls, the compliance officers who codify the procedures, the operations leads who maintain the playbooks.
Forge takes a different premise. A SKILL.md
is a markdown document with structured frontmatter. The frontmatter declares what the
skill needs. The body is instructions written for an LLM, in the same prose you'd use in
a runbook or playbook. Scripts are optional — used when the LLM needs deterministic tools
to call — and they live in a separate directory that domain experts don't have to touch.
The agent, as an artifact, is something a non-coder can read, review, write, and
version-control.
That structural choice opens Forge to three audiences who collaborate naturally through the document.
Domain experts who author skills
If you write runbooks today — operational procedures, incident response steps, security playbooks, audit procedures, support escalation paths, customer onboarding sequences — you can write Forge skills. The format is the same prose you already write, with a frontmatter block on top declaring what tools and integrations the skill needs.
Concretely: an SRE who has documented their pod-restart triage process can turn that
documentation into a working agent by adding frontmatter declaring access to
kubectl
and a few environment variables. A security engineer who maintains a vulnerability-triage
playbook can convert it into a skill that the LLM follows step-by-step. A compliance
officer who maintains a quarterly access-review procedure can codify it as a skill that
runs on a schedule and produces the evidence artifact the audit needs.
The Skill Builder UI — opened with forge ui
and served locally with no external dependency — is designed for this audience. It gives
a structured editor for the frontmatter, a markdown editor for the body, and immediate
preview of how the agent will execute. No Python, no framework, no deployment manifest.
What domain experts get from Forge:
- The agent is a document they can author and review without writing code.
- The same skill that lives in their team's Confluence or runbook repository can be made executable without rewriting.
- Skills are versioned in git, reviewed in pull requests, and signed for production use — the same workflow operational documents already follow at most organizations.
- Domain experts can iterate on a skill without involving an engineer for every change, the way they iterate on documentation today.
Developers who extend skills with tools
Many skills need more than what an LLM can do alone. They need to call APIs, query databases, run kubectl commands, parse complex outputs, or perform deterministic actions where LLM judgment is unsafe. That's where developers come in.
Forge skills can include scripts in their scripts/
directory — Bash, Python, Go, anything. The frontmatter declares which scripts the
skill exposes as tools. The LLM, reading the skill body, sees the tools as named
functions it can invoke. A developer writes the script once; the domain expert who owns
the skill body uses it as a tool the way an LLM uses any other tool.
The collaboration shape: a domain expert writes the skill body in markdown, naming the tools they'd like the agent to have. A developer reads the skill, writes the scripts for the tools the domain expert specified, declares them in frontmatter. The domain expert iterates on the body without touching scripts. The developer iterates on scripts without touching the body. Both versions live in the same SKILL.md directory and are reviewed together.
What developers get from Forge:
- A clear contract between domain logic (markdown body) and tool implementation (scripts in any language).
- A runtime that handles LLM invocation, tool dispatch, egress enforcement, and audit logging — so developers focus on the tool, not the agent infrastructure.
-
The same multi-language tool support across every Forge deployment — develop locally
with
forge run, ship withforge package, deploy with the standard Kubernetes manifest.
Platform engineers who operate the runtime
Once skills exist, they need to run somewhere production-grade. Platform engineers, SREs (in their operator capacity), and DevOps teams are the audience for Forge's runtime layer — the single static binary, the Kubernetes deployment patterns, the egress enforcement model, the audit logging, the autowire trust pipeline.
This audience cares about: how does the runtime fit alongside the services we already operate? What's its resource footprint? How does it observe through our existing Prometheus and Grafana? How does it authenticate with the IdP we already use? Can we run it air-gapped? Can it survive a node failure? Can the security team review it end-to-end?
Forge is designed to make those questions cleanly answerable. The runtime is a Go binary, no daemon, no DinD, no managed-service dependency. It deploys with standard Kubernetes manifests. It enforces egress at the runtime layer with per-skill allowlists. It emits structured audit logs with correlation IDs. It supports local model inference for air-gapped deployment. It can be embedded in another service as a library when that fits the architecture better.
What platform engineers get from Forge:
- A single static binary they can deploy with whatever orchestration they already use.
- A runtime security model that doesn't depend on the underlying cloud — same egress controls and audit posture on EKS, AKS, GKE, or on-prem.
- Zero managed-service dependency, zero phone-home, no vendor billing surface beyond model APIs.
- Standard observability via OpenTelemetry — flows into the SIEM and metrics platform already operating.
How the three audiences collaborate
The SKILL.md format is the contract. Domain experts write the body. Developers write the scripts. Platform engineers operate the runtime. The same document is the source of truth for all three roles.
A working example: an enterprise SRE team wants an agent that triages Kubernetes incidents. The senior SRE who knows the team's actual triage process writes the skill body in markdown — the diagnostic steps, the safety constraints, the escalation rules. The platform team's developer writes scripts for the kubectl invocations and the Slack notifications. The platform engineer deploys the skill as a Kubernetes sidecar to the cluster being monitored, with audit logs flowing into Splunk and egress restricted to the cluster's internal API only.
Every change to the agent's behavior — refining the triage process, adding a new escalation rule, tightening the egress allowlist — happens through pull requests against the SKILL.md repository. The domain expert reviews body changes. The developer reviews script changes. The platform engineer reviews frontmatter and deployment changes. The agent improves like any other operational document, with the right people reviewing the parts they own.
That's the difference between an agent as code and an agent as document. Code excludes everyone who doesn't write code. Documents include everyone who can read them, and the contract between roles is visible to all of them.
What about non-developers running their own personal agents?
Forge is not designed for the "I want an agent to help with my email and my calendar on my Mac" use case. That's a desktop assistant, and Claude Cowork is the right product for it. Cowork runs on your laptop, talks to the SaaS apps you personally use, completes tasks on your behalf, and shuts down when you don't need it.
Forge is designed for the agent that runs as a service — for your team, your organization, your customers. The author of that agent might not be a developer (and often isn't — the best people to author production runbook-style agents are the SREs, security engineers, and operations leads who own the underlying processes). But the agent itself lives in your infrastructure, runs continuously or on schedule, and serves a function that goes beyond one person's productivity.
The distinction is the deployment shape and audience of the agent, not the technical sophistication of the author:
- A non-developer building an agent for themselves, on their machine → Claude Cowork
- A non-developer building an agent for their organization, running as a service → Forge
Getting started by audience
If you're a domain expert authoring skills
Start with forge init my-skill
to scaffold a new SKILL.md. Open the Skill Builder UI with
forge ui
for a structured editor. The
SKILL.md spec
documents the frontmatter fields, and the
writing-custom-skills guide
walks through the practical patterns: how to structure the body, when to add scripts
vs ask the LLM to reason, how to declare egress, how to test locally with
forge run.
If you're a developer writing tools
The writing-custom-skills guide covers the tool-script interface — how scripts declare arguments, how they return results, how the LLM sees them. For the embedded-skills catalog (existing scripts you can take patterns from), see embedded skills .
If you're a platform engineer deploying Forge
Start with the installation guide for the binary. The Kubernetes deployment guide covers the standard manifest patterns. The security overview documents the trust model, egress enforcement, and audit logging. For enterprise deployment with signing, RBAC, and on-prem registry, see Forge Hub .