Skip to content

Simplify skill: trust the agent, keep the engine - #4

Merged
artvandelay merged 3 commits into
mainfrom
simplify-skill
May 26, 2026
Merged

Simplify skill: trust the agent, keep the engine#4
artvandelay merged 3 commits into
mainfrom
simplify-skill

Conversation

@artvandelay

Copy link
Copy Markdown
Owner

Removes defensive prose that capable agents handle naturally. Keeps the deterministic engine and its tests untouched.

Before / after

File Before After
SKILL.md 569 lines 67 lines
INPUTS.md 59 lines 41 lines
README.md minor cleanup
scripts/calc.py unchanged unchanged
tests/ unchanged (22/22 pass) unchanged

Commits

  1. Simplify SKILL.md — drop Trust boundary, Phase 7 multi-turn tables, Input sanity bounds, 15+ failure-mode subsections, mandatory 6-cell matrix, clarify pseudocode. Keep: workflow, three hard rules, one example payload per subcommand, MoE / infeasible / api_wins / quality notes.
  2. Simplify INPUTS.md — schema tables only. Drop extraction-hint paragraphs and confidence-when-defaulted column. Engine's exit-2 JSON is self-describing.
  3. README — 5-step workflow, correct scripts/calc.py path, drop 6-cell matrix language.

Bets

  • Multi-turn revisions: agent re-runs calc.py when inputs change.
  • Spot pricing / unknown GPUs / conflicting bills: agent handles with common sense.
  • Prompt injection: host LLM alignment handles it.
  • Validation: scripts/calc.py still rejects bad input with exit 2.

If something regresses, add one sentence — not a 70-line section.

Cuts SKILL.md from 569 to ~60 lines by removing defensive prose
that capable agents handle naturally:
- Trust boundary / anti-sunk-cost / engine substitution rules
- Phase 7 multi-turn revision tables
- Input sanity bounds
- 15+ failure-mode subsections
- Mandatory 6-cell scenario matrix
- Pseudocode clarify loop

Kept: deterministic engine contract, live fetch URLs, three hard
rules, one example payload per subcommand, MoE / infeasible /
api_wins / quality notes. calc.py still enforces input validation
and honest infeasible output.
Drop extraction-hint paragraphs, confidence-when-defaulted column,
and validation-errors section. The engine's exit-2 JSON is already
self-describing; extraction hints are agent common sense.
5-step workflow (not 6), correct scripts/calc.py path in file list,
drop 6-cell matrix claim.
@artvandelay
artvandelay merged commit ad518b0 into main May 26, 2026
3 checks passed
@artvandelay
artvandelay deleted the simplify-skill branch May 26, 2026 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant