newb 0.4.0

Test your package through the eyes of a newbie agent — a fresh AI agent reads only your docs/skills and tries to use your package.

newb

A fresh AI agent reads only your _skills/ (or equivalent docs) and tries to use your package. If it succeeds, your docs work.

Install

pip install newb

Use

newb ./src/mypkg/_skills/mypkg
newb ./_skills --format markdown >> README.md

Spins up a clean docker container with only your skills mounted, then asks a fresh Claude agent four canonical questions (what for / problems / quick start / when not to use), plus optional red tests from _red_tests.yaml.

Output: JSON (for CI) or markdown (for README injection).

Library

import newb
report = newb("./src/mypkg/_skills/mypkg")
print(newb.render_markdown(report))

Requirements

• Docker on PATH
• ANTHROPIC_API_KEY in env
• Python 3.10+

License

AGPL-3.0-only.