# Agent Skills \[Install Newton Agent Skills for versioned policy, PolicyClient, and application workflows]

Newton Agent Skills replace the previous standalone LLM context files. Skills are versioned alongside templates and references, split by task, and designed to resume work through machine-readable handoff files.

:::warning
The skills are under active dogfood testing. Review generated code and report friction instead of silently working around it.
:::

## Available skills

| Skill | Use when |
|---|---|
| `newton-policy` | Installing `newton-cli`, authoring Rego + WASM, and running the local build/simulate loop |
| `newton-policy-client` | Adding `_validateAttestationDirect` to a Solidity integration and testing intent binding |
| `newton-demo` | Turning a brief into a policy, PolicyClient, and local Next.js application |

The skills preserve state in `policy-handoff.json`, `client-handoff.json`, and `demo-config.json`. These files contain addresses and intent configuration, but never credentials.

## Install

```bash
git clone https://github.com/newt-foundation/newton-agent-skills.git
cd newton-agent-skills
```

For local Cursor or Codex discovery while the skills repository is the workspace:

```bash
mkdir -p .agents
ln -sfn ../skills .agents/skills
```

For Claude Code, copy the folders into `.claude/skills/` or `~/.claude/skills/`. Other Agent Skills clients can load the required folders from `skills/` using their supported discovery directory.

## Safety model

* Local policy work does not require login or deploy credentials.
* The agent must not request private keys, API keys, JWTs, or RPC credentials in chat.
* Deployment, gateway evaluation, the first attested transaction, and hosting require separate user confirmation.
* `NEWTON_API_KEY` belongs on the server, never in a `NEXT_PUBLIC_*` variable or browser bundle.

<Card title="Build with an Agent" icon="play" to="/developers/overview/agent-quickstart">
  Install the skills, write a brief, review local results, and approve live checkpoints
</Card>

<Card title="Newton Agent Skills on GitHub" icon="github" to="https://github.com/newt-foundation/newton-agent-skills">
  Browse the current skills, references, templates, and sample briefs
</Card>