Newt Blueprint Generator — Claude Code skill: features and install
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.
no license 303 installs ★ 93 updated 2025-10-20
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a claude-codeWhat Newt Blueprint Generator 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.
What it helps with
- 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 for the agent
- 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.
How to install Newt Blueprint Generator
1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a claude-code2Manually: put the files in place
~/.claude/skills/newt-blueprint-generator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/newt-blueprint-generator/
1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a codex2Manually: put the files in place
.agents/skills/newt-blueprint-generator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a cursor2Manually: put the files in place
.cursor/skills/newt-blueprint-generator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rknall/claude-skills newt-blueprint-generator2Manually: put the files in place
.github/skills/newt-blueprint-generator/SKILL.md1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a gemini-cli2Platform CLI
gemini skills install https://github.com/rknall/claude-skills --path newt-blueprint-generatorManually: put the files in place
.devin/skills/newt-blueprint-generator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill newt-blueprint-generator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about Newt Blueprint Generator
How do I install Newt Blueprint Generator in Claude Code?
Run npx skills add rknall/claude-skills --skill newt-blueprint-generator -a claude-code. The skill file is at ~/.claude/skills/newt-blueprint-generator/SKILL.md.
What does Newt Blueprint Generator do?
It helps create and check Pangolin Newt blueprints in YAML or Docker Labels. Its examples cover proxy resources, Olm client resources, and authentication.
Can I configure authentication for a TCP resource?
No. Authentication settings apply to HTTP resources, not TCP or UDP.