Add example package, structure checker, and 4 new references

New features:
- examples/my-package: complete reference implementation (22/22 checks pass)
- scripts/check-structure.py: audit project against pyckage conventions
- .github/workflows/check-budget.yml: CI token budget check on PRs

New references:
- 08-pre-commit.md: pre-commit hooks with ruff, mypy, pre-commit-hooks
- 09-cli-entry-points.md: CLI with argparse/click, entry points, testing
- 10-monorepo.md: uv workspaces, namespace packages
- 11-automated-release.md: bump-my-version, conventional commits, git-cliff

Updated:
- 03-testing.md: replaced pandas fixtures with generic dicts + tmp_path
- SKILL.md: added new references to routing table, new subcommands
- README.md: updated structure and usage sections

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Naareman

.github/workflows/check-budget.yml

@@ -0,0 +1,11 @@
+name: Check Token Budget
+on: pull_request
+jobs:
+  budget:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python scripts/count-tokens.py .

README.md

@@ -46,6 +46,8 @@ pyckage activates automatically when you're working on Python package tasks. You
 /pyckage lifecycle                  # Manage deprecations and versioning
 /pyckage release                    # Walk through the PyPI release ritual
 /pyckage check                      # Audit your project for common mistakes
+/pyckage pre-commit                 # Set up pre-commit hooks
+/pyckage cli                        # Add a CLI to your package
 /pyckage                            # Assess your project against all 5 principles
 ```
 
@@ -93,16 +95,26 @@ Before diving into details, you should be able to see the whole thing working en
 pyckage/
 ├── SKILL.md                          # Main skill definition (philosophy + routing)
 ├── README.md                         # This file
+├── examples/
+│   └── my-package/                   # Complete reference implementation (22/22 checks)
 ├── references/
 │   ├── 01-scaffold.md                # Package scaffolding (the "whole game")
 │   ├── 02-api-design.md              # Naming, messages, errors
 │   ├── 03-testing.md                 # pytest conventions and patterns
 │   ├── 04-docs.md                    # Docstrings + mkdocs-material
 │   ├── 05-lifecycle.md               # Deprecation ceremony + versioning
 │   ├── 06-release.md                 # PyPI publishing + GitHub Actions
-│   └── 07-common-mistakes.md         # Python packaging anti-patterns
-└── scripts/
-    └── count-tokens.py               # Token budget checker
+│   ├── 07-common-mistakes.md         # Python packaging anti-patterns
+│   ├── 08-pre-commit.md              # Pre-commit hooks setup
+│   ├── 09-cli-entry-points.md        # Adding a CLI to your package
+│   ├── 10-monorepo.md                # Monorepo + namespace packages
+│   └── 11-automated-release.md       # Automated version bumps + changelog
+├── scripts/
+│   ├── count-tokens.py               # Token budget checker
+│   └── check-structure.py            # Audit project against pyckage conventions
+└── .github/
+    └── workflows/
+        └── check-budget.yml          # CI: token budget check on PRs
 ```
 
 ## Token Budget

SKILL.md

@@ -6,7 +6,7 @@ description: >
   mkdocs-material. Activate when creating/structuring Python packages, designing APIs,
   naming functions, adding user messages/errors, writing tests, setting up docs, managing
   deprecations, or publishing to PyPI.
-argument-hint: "[scaffold|api|test|docs|lifecycle|release|check] [package-name]"
+argument-hint: "[scaffold|api|test|docs|lifecycle|release|check|pre-commit|cli] [package-name]"
 ---
 
 # pyckage
@@ -32,6 +32,10 @@ relevant reference file from `references/`:
 | Adding deprecations or managing versions | [references/05-lifecycle.md](references/05-lifecycle.md) |
 | Releasing to PyPI or setting up CI/CD | [references/06-release.md](references/06-release.md) |
 | Auditing for common anti-patterns | [references/07-common-mistakes.md](references/07-common-mistakes.md) |
+| Setting up pre-commit hooks | [references/08-pre-commit.md](references/08-pre-commit.md) |
+| Adding a CLI to your package | [references/09-cli-entry-points.md](references/09-cli-entry-points.md) |
+| Managing a monorepo / namespace packages | [references/10-monorepo.md](references/10-monorepo.md) |
+| Automating releases (bump, changelog, CI) | [references/11-automated-release.md](references/11-automated-release.md) |
 
 Read only what's relevant to the current task. Don't load everything at once.
 
@@ -110,6 +114,8 @@ When invoked with `/pyckage <subcommand>`, route based on the first argument:
 | `/pyckage lifecycle` | Read [references/05-lifecycle.md](references/05-lifecycle.md) and manage deprecations |
 | `/pyckage release` | Read [references/06-release.md](references/06-release.md) and walk through the release ritual |
 | `/pyckage check` | Read [references/07-common-mistakes.md](references/07-common-mistakes.md) and audit current project for anti-patterns |
+| `/pyckage pre-commit` | Read [references/08-pre-commit.md](references/08-pre-commit.md) and set up pre-commit hooks |
+| `/pyckage cli` | Read [references/09-cli-entry-points.md](references/09-cli-entry-points.md) and add a CLI to the package |
 | `/pyckage` (no args) | Assess the current project against all five principles (see checklist below) |
 
 When invoked without a subcommand (auto-triggered or plain `/pyckage`), run this assessment:

examples/my-package/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+*.egg
+.venv/

examples/my-package/.python-version

@@ -0,0 +1 @@
+3.12

examples/my-package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [Unreleased]
+
+### Added
+
+- `read_csv()` -- read a CSV file into a list of dicts.
+- `validate_schema()` -- check that required columns exist.
+- Custom error hierarchy: `MyPackageError`, `ValidationError`, `FileFormatError`.

examples/my-package/README.md

@@ -0,0 +1,23 @@
+# my-package
+
+A tiny CSV reader utility.
+
+## Installation
+
+```bash
+pip install my-package
+```
+
+## Quick start
+
+```python
+from my_package import read_csv, validate_schema
+
+# Read a CSV file into a list of dicts
+rows = read_csv("people.csv")
+
+# Ensure required columns exist
+validate_schema(rows, ["name", "age"])
+
+print(rows[0]["name"])  # Alice
+```

examples/my-package/docs/api.md

@@ -0,0 +1,15 @@
+# API Reference
+
+## Core
+
+::: my_package.core
+    options:
+      show_source: false
+      heading_level: 3
+
+## Errors
+
+::: my_package.errors
+    options:
+      show_source: false
+      heading_level: 3

examples/my-package/docs/index.md

@@ -0,0 +1,18 @@
+# my-package
+
+A tiny CSV reader utility.
+
+## Installation
+
+```bash
+pip install my-package
+```
+
+## Quick start
+
+```python
+from my_package import read_csv, validate_schema
+
+rows = read_csv("data.csv")
+validate_schema(rows, ["name", "age"])
+```

examples/my-package/mkdocs.yml

@@ -0,0 +1,17 @@
+site_name: my-package
+site_description: A tiny CSV reader utility.
+
+theme:
+  name: material
+
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            docstring_style: google
+
+nav:
+  - Home: index.md
+  - API Reference: api.md