# Newt Blueprint Generator

Newt Blueprint Generator is a skill for creating and validating Pangolin Newt configurations in YAML or Docker Labels. It covers proxy and client resources, access rules, and Docker Compose setups.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 303 installs · ★ 93 repo stars
- Author: rknall
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rknall/claude-skills/tree/HEAD/newt-blueprint-generator/SKILL.md
- Updated: 2025-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/newt-blueprint-generator

## What it does

The skill assists with Pangolin Newt resource definitions in YAML files and Docker Compose labels. It can also review configurations and help diagnose validation errors. Supported examples cover HTTP, TCP, and UDP proxies, Olm client resources, and authentication settings.

YAML blueprints can describe domains, targets, headers, and access rules. For Docker-based setups, resource settings use labels beginning with `pangolin.`; definitions from multiple containers can be combined. Newt can detect a container’s hostname and internal port when those values are left out.

Authentication is restricted to HTTP resources, so TCP and UDP proxies cannot use those settings. Choose HTTP if the resource needs authentication. Docker label discovery also requires Newt to access the Docker socket.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/newt-blueprint-generator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/newt-blueprint-generator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/newt-blueprint-generator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/newt-blueprint-generator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rknall/claude-skills newt-blueprint-generator
```

2. **Manually: put the files in place**
- File: `.github/skills/newt-blueprint-generator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rknall/claude-skills --path newt-blueprint-generator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/newt-blueprint-generator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/rknall/claude-skills/tree/HEAD/newt-blueprint-generator/SKILL.md

## When to use it
- draft a YAML proxy resource configuration
- define Newt resources with Docker Compose labels
- set proxy targets and ports
- add authentication to an HTTP resource
- diagnose blueprint validation errors

## Example prompts
- Create a Pangolin Newt YAML blueprint for an HTTP proxy with a domain and two targets.
- Review my blueprint and explain its validation errors.
- Convert these Newt resource settings from YAML into Docker Compose labels.

## Similar
- [docker-compose](https://affpapa.org/en/nevibecode/skills/docker-compose.md) — skill · 614 installs
- [docker-patterns](https://affpapa.org/en/nevibecode/skills/docker-patterns.md) — skill · 8600 installs
- [docker](https://affpapa.org/en/nevibecode/skills/mindrally-docker.md) — skill · 1200 installs
- [docker-development](https://affpapa.org/en/nevibecode/skills/docker-development.md) — skill · 702 installs
- [docker-compose-production](https://affpapa.org/en/nevibecode/skills/docker-compose-production.md) — skill · 487 installs
- [compose-patterns-2025](https://affpapa.org/en/nevibecode/skills/compose-patterns-2025.md) — skill · 179 installs

From the same set: [rknall/claude-skills](https://affpapa.org/en/nevibecode/by/rknall/claude-skills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
