diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..6964f52
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+# Python bytecode cache
+__pycache__/
+*.pyc
diff --git a/README.md b/README.md
index 2b5e8b4..e78fb60 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,15 @@
+---
+> **Note:** This repository is published for reference. The contents below were
+> auto-generated by Claude Code (Anthropic) as a deliverable in November 2025.
+> The core concept — separating deterministic operations from agent reasoning —
+> is sound, but my approach has since evolved. I now use
+> [Pi.dev](https://pi.dev) with a more conversational prompting style, favouring
+> **extensions** (in-process deterministic plugins that are ~10× faster than
+> shell scripts and easier to debug) over compiled Go binaries generated by this
+> skill. The lines between stored prompts, plugins, and ad-hoc instructions have
+> blurred; this repo documents an earlier point in that journey.
+---
+
 # Meta Skill Generator - Deliverables
 
 ## 📦 What You're Getting
@@ -32,9 +44,20 @@ Interactive workflow that:
 ## 📄 Files Included
 
 ### Main Deliverable
-**[meta-skill-generator.skill](computer:///mnt/user-data/outputs/meta-skill-generator.skill)** (43 KB)
-- Complete packaged skill ready to use
-- Install in Claude Code to start creating skills
+**[meta-skill-generator.skill](./meta-skill-generator.skill)** (43 KB)
+
+> **What is a `.skill` file?** It's a ZIP archive containing the full skill
+> source. The Python scripts, SKILL.md, and reference documents are all packaged
+> inside. If you clone this repo and wonder where the source code went — it's in
+> the `.skill` file. Extract it with:
+> ```bash
+> unzip meta-skill-generator.skill -d ./source
+> ```
+> This has already been done; the extracted source lives in
+> [`source/meta-skill-generator/`](./source/meta-skill-generator/).
+
+- Complete packaged skill (ZIP format) ready for Claude Code
+- Source extracted to [`source/`](./source/meta-skill-generator/) for reference
 
 ### Documentation
 1. **[META-SKILL-GENERATOR-GUIDE.md](computer:///mnt/user-data/outputs/META-SKILL-GENERATOR-GUIDE.md)** - Complete user guide
diff --git a/TODO.md b/TODO.md
index b2db6fb..b9633cd 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1,4 +1,12 @@
-- Add creative commons license
-- Add note on top of README that it is auto-generated and I am publishing this for reference. Larger coding agents like Claude Code seem to have some of this built in, and I prompt for this now in a more conversational style with Pi.dev, going for extensions (deterministic plugins) first, stored prompts separately sometimes referring to plugins. The lines are more blurred. Code like extensions that live in the same process as the coding agents are probably an order of magnitude faster than shell scripts, and a lot easier to reason about and debug (since they are in process you also get the stack traces and crashes right away - let it crash).
-- Make public
-- where did the skill go?
+# TODO
+
+## Done
+- [x] Add note on top of README explaining this is auto-generated and published for reference
+- [x] Document the `.skill` ZIP format and where the source went
+- [x] Extract source from `.skill` into `source/`
+
+## Remaining
+- [ ] Add Creative Commons license file (e.g., CC-BY-4.0)
+- [ ] Review and clean up `source/meta-skill-generator/scripts/__pycache__/` (`.pyc` files — can be deleted, they're build artifacts)
+- [ ] Make repo public
+- [ ] Optionally: add a brief `ARCHITECTURE.md` capturing the evolution from this approach to Pi.dev extensions
diff --git a/mise.toml b/mise.toml
new file mode 100644
index 0000000..59a67ac
--- /dev/null
+++ b/mise.toml
@@ -0,0 +1,2 @@
+[tools]
+node = "latest"