What belongs in a skill
A skill packages instructions for a job the AI should perform consistently. It can include references, scripts, templates, and routing guidance. Keep the instruction focused on one job and make consequential boundaries explicit.
- When the skill should be used.
- The result it must produce.
- The evidence it should inspect.
- Which tools or actions are permitted.
- When it must stop for approval or hand work to a person.
Install policy
Treat a skill as executable operating material. Review its instructions and bundled code before installation. Unverified npm and git sources are gated by installation policy; only loosen that policy for sources the operator is prepared to trust.
Test and review
- Test against sample or non-production data.
- Inspect tool requests and generated files.
- Confirm that policy blocks work outside the intended scope.
- Enable the skill for a small operator group before broader use.