donaldfilimon/abi / .claude/skills/nn-demo
nn-demo
VerifiedBuild the abi CLI and run the miniature character-level neural-net demo — `nn train` (real manual-backprop char-LM) and `nn sample` (train-then-generate). Use to train, sample, or smoke-test the nn demo trainer, or verify nn after touching crates/abi-nn/. This is a demo trainer, NOT a production/LLM/distributed trainer.
nn-demo — drive abi's character-level demo trainer
Driver: .agents/skills/nn-demo/nn.sh (paths relative to repo root).
Builds the CLI and drives abi nn train + abi nn sample. Evidence is the
RESULT: line. Fully local, no network.
Run (agent path)
.agents/skills/nn-demo/nn.sh # default corpus, seed 't', n=20
.agents/skills/nn-demo/nn.sh "hello world hello there" h 24 # custom corpus / seed / n
nn train "<corpus>"— assertsnn train:,final_loss=,steps=.nn sample --text "<corpus>" --seed <char> --n <k>— trains, then generates; assertsnn sample:.
Prints RESULT: PASS (exit 0) or a FAIL count.
Current Rust driver: requires real train-loss/step markers and a generated sample while deliberately avoiding a fixed numerical-quality claim.
Gotchas
- ⚠️ Demo, not a production trainer.
nnis a pure-Rust hand-derived-backprop char-LM for demonstration — it is not an LLM, not distributed, not a real training stack. Loss values vary run-to-run; the driver asserts structural markers (final_loss=,steps=), not a specific loss. nn sample's--seedis the seed character for generation, not an RNG seed.nn sampletrains first, so its output has a leadingnn train:line.nn train --jsonl <path> [--field <name>]trains from a JSONL corpus; the driver exercises the inline-text path. For source analysis, readcrates/abi-nn/src/.
Troubleshooting
| Symptom | Fix |
|---|---|
build FAIL | Use ./tools/cargo.sh build -p abi-cli, then ./tools/check.sh. |
missing nn train: / nn sample: | Output grammar drift — check the nn handler in crates/abi-cli/src/ and crates/abi-nn/src/. |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |