Skip to content

hassan-mohiddin/freeflow / .deprecated/skill-tooling-pre-rewrite/skill-eval/evaluate-skill/fixtures/v3-legacy/accepted-bundle/evidence/candidate/inputs/skill

write-skill

Verified

Create or revise agent skills. Use when defining a skill's trigger description, active instructions, stop conditions, structure, examples, references, scripts, or readiness status.

references/progressive-disclosure.md

View on GitHub
# Progressive Disclosure

Keep high-frequency decisions in `SKILL.md`. Move conditional depth only when it improves execution.

## Add A Reference When

- the material is needed only for a distinct branch of work;
- loading it every time would obscure higher-priority rules;
- the active file can link it with a clear read condition.

## Add A Script When

- the work is deterministic and repeated;
- retyping it is error-prone, unsafe, or materially wasteful;
- tests can prove its behavior.

Do not script ordinary shell commands merely to look complete.

## Resource Test

For every extra file, answer:

1. Which measured failure requires it?
2. When will the agent load or run it?
3. Why cannot the active file or a direct command do the job?
4. How will it be validated and kept current?

If those answers are weak, remove the resource.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall