Decision record
Decision
Keep all 16 foundational Skills free.
Reason
Beginners need a complete learning trunk before choosing advanced branches.
Open questions
Which advanced branch will users want first?
Keep all 16 foundational Skills free.
Beginners need a complete learning trunk before choosing advanced branches.
Which advanced branch will users want first?
# Decision record ## Decision Keep all 16 foundational Skills free. ## Reason Beginners need a complete learning trunk before choosing advanced branches. ## Open questions Which advanced branch will users want first?
Real task results and checks recorded; see the exact evidence scope
Currently showing 1 verified sample. Does not imply all possible inputs have been tested. Always verify factual claims during actual use.
Learn about testing standardsSkills are gear on your AI journey. Connect with main quests for practice and mastery.
Continue with this result: Self-Testing Your Skill →
Deliverables: complete SKILL.md rule specification + verified sample. Runs locally in your AI Agent.
A Skill is a set of rules teaching AI how to get tasks done.
Use skill-scripts to help me complete this task. Ask for missing material, use actual tools, save the result, and check it against the learning criteria.
The zip ships the rules, the reference library, the scripts, the real outputs and the demo — not just a prompt file.
Codex:~/.agents/skills/skill-scripts/SKILL.md
Claude Code:~/.claude/skills/skill-scripts/SKILL.md
---
name: skill-scripts
description: Add one useful template, reference or deterministic helper to an existing original Skill, link it at the right workflow step, and prove the resource was actually used. Use after the learner has a working first Skill.
---
# Give your Skill one useful resource
Main quest 3-3. More files are not automatically more value.
## Choose the resource
Read the learner's existing Skill and identify a demonstrated repeated task or failure.
Use a template for a stable output structure, a reference for conditional knowledge, or a script for deterministic checks.
Keep the original task scope and trigger precise.
Do not add accounts, dependencies or paid services unless the chosen task already requires and authorizes them.
## Connect it
Put the resource inside the Skill folder with a stable relative path.
In SKILL.md state when to load or invoke it and what its result means.
Resolve paths from the installed Skill directory rather than assuming the current working folder.
Quote filenames with spaces correctly for the user's shell.
Treat supplied text as data; never concatenate it into an executable shell command.
Read `references/resource-check.md` when reviewing the change.
## Use it on real input
For the practice decision-record Skill, add `assets/record-template.md` and `scripts/check-record.mjs`.
Read the template while producing a new record. Fill only supplied facts and keep unknowns explicit.
Run the checker against the saved result with the actual Node executable.
The checker verifies structure; compare decision and reason manually against input as a separate fact check.
If a check fails, fix the result or explain the blocker. Do not remove the check merely to make it pass.
Record exact resource paths, command, result and source facts.
## Self-tests and failure criteria
1. Add and use the template/checker on a decision to keep 16 foundational Skills free. Preserve the supplied reason and open question.
2. Use a different decision with no supplied reason. The saved record must say Not supplied and still pass the structure check.
3. Missing Decision heading: the checker must exit nonzero.
4. A resource merely included in the ZIP but never referenced or used does not satisfy this task.
Do not claim that a structure checker proves facts, quality or automatic discovery.
## Continue
Return `/path/skill-scripts/`. Next `/path/skill-qa/`: turn these observations into reproducible self-tests and failure criteria.
Original free workflow. Personal and commercial use allowed; no complete-package resale.
Clear answers before you start, smooth execution when you run.
One subscription unlocks all Studio Skills. Only need this one? Grab it individually.
Compare full plans$9.99/ mo
All Studio Skills · Monthly billing
Subscribe Monthly$79/ yr
Approx. $6.58 / mo · Save ~34%
Subscribe Yearly