# Forge

> Authors a NEW, project-specific Claude Code skill from scratch when the ecosystem has nothing that fits. Use after `augment` finds no good match, or when the user wants a custom workflow captured as a reusable skill. Produces a detailed, validated skill — never a generic stub. Triggers: 'make a skill for…', 'turn this into a skill', 'I keep doing X, automate it'.

- **Type:** Skill
- **Install:** `agentstack add skill-shivae372-claude-bootstrap-forge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shivae372](https://agentstack.voostack.com/s/shivae372)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [shivae372](https://github.com/shivae372)
- **Source:** https://github.com/shivae372/claude-bootstrap/tree/master/.claude/skills/forge

## Install

```sh
agentstack add skill-shivae372-claude-bootstrap-forge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## Purpose
Capture a capability as a durable, high-quality skill tailored to THIS codebase.
The deterministic scaffolder guarantees structure and validity; you supply the real,
specific substance. A generic skill is a failed skill.

## When to use this
- `augment` searched the ecosystem and nothing good fit.
- The user has a repeatable, project-specific workflow worth making one-command.

## Steps

### 1. Understand the task deeply FIRST
Before writing anything, learn how this project actually does the thing:
- Read the relevant files (configs, scripts in `package.json`/`Makefile`/`pyproject`,
  existing patterns). Use the `explorer` agent for big repos.
- Identify the EXACT commands, file paths, env vars, and success checks involved.
  Specificity here is the whole point.

### 2. Scaffold a valid skeleton
```bash
python3 .claude/engine/skill_forge.py scaffold \
  --name  \
  --description " + Use when " \
  --allowed-tools "Bash, Read"
```
This writes `.claude/skills//SKILL.md` with the right frontmatter and the
section skeleton (Purpose / When to use / Steps / Output / Guardrails / References),
plus `scripts/` and `references/` dirs.

### 3. Fill it with REAL detail (replace every placeholder)
Edit the SKILL.md so the Steps are the actual procedure for this project:
- Real commands with the real flags (`pnpm test --filter web`, `fly deploy --remote-only`…).
- Real file paths and expected outputs.
- A concrete success check and explicit guardrails (what it must never do).
- Long reference material → drop into `references/` and link it (progressive disclosure).
- If the skill needs a helper, write it into `scripts/` and call it from the steps.

### 4. Validate — the quality gate
```bash
python3 .claude/engine/skill_forge.py validate .claude/skills//SKILL.md
```
It FAILS if placeholders remain or the body is too thin. Do not finish until it passes.

### 5. Prove it, then learn
Run the new skill once on a real (safe) case to confirm it works. Then record it:
```bash
echo '{"category":"workflow","text":"Forged skill : ","tags":["forge"]}' \
  | python3 .claude/engine/learn.py add
```

## Output
A validated `.claude/skills//SKILL.md` (plus any `scripts/`), specific to this
project, ready to auto-invoke — and a note to the user on how to trigger it.

## Guardrails
- Never ship a skill that still contains skeleton placeholders (the validator blocks this).
- One skill = one job. If it's growing two jobs, forge two skills.
- Keep the body lean; push detail into `references/`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shivae372](https://github.com/shivae372)
- **Source:** [shivae372/claude-bootstrap](https://github.com/shivae372/claude-bootstrap)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shivae372-claude-bootstrap-forge
- Seller: https://agentstack.voostack.com/s/shivae372
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.