Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/jrgilbertson/the-rookery --skill creating-portable-skillsPrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
Creating Portable Skills
Produce an installable package that does the user's reusable job and follows the Agent Skills specification. Add behavioral evals when observed failures warrant them under the host's evaluation policy.
For a read-only audit, apply references/review-checklist.md and return prioritized findings with file evidence and a verdict. For authorized creation, revision, or migration, use the workflow below. Existing authorization and the host project's constraints carry forward.
Author the package
Ground the skill in the user's intent, existing package, representative inputs and outputs, and corrections from real work. Identify the outcome and hard constraints that make completion acceptable. Check the host's contribution rules, discovery path, and existing owners before adding a workflow or helper.
For a new skill, use assets/skill-template.md. For a revision, the last commit can preserve the prior version. For a migration, revise a copy and preserve the source. Read references/portability.md when choosing frontmatter, bundling dependencies, or removing harness-specific assumptions.
Keep one instruction set for the job. Separate changing facts from reusable instructions when that lets the next update change one source. Put conditional guidance in references/, copied outputs in assets/, and deterministic helpers in scripts/ when an existing mechanism cannot meet the requirement. Bundle everything the package needs, or declare its actual environment dependencies.
Apply references/review-checklist.md while drafting. Preserve user authority, exact formats, privacy requirements, and fragile operation order; leave reasoning and implementation choices open.
Validate and evaluate
Use skills-ref validate <skill-directory> from an available trusted install. If it is unavailable, check the specification's frontmatter rules, name-directory match, body, and local resource links directly, and record the limitation. Exercise bundled helpers with realistic inputs in disposable storage outside the host project; preserve existing inputs and outputs.
Package checks, helper tests, and applicable authorized smoke checks run for every package. For behavioral evaluation, follow references/evaluation.md.
Deliver
Check the final package's local links, dependencies, host conventions, and applicable evaluation evidence. Report the package location, observed checks, and anything unverified. For public migrations, replace private examples with synthetic inputs that preserve the behavior and difficulty being tested, and inspect the whole copy for leaks. Keep answers and grading material outside the runtime instructions. Follow the host's release and installation process.
Sources
The Agent Skills specification owns the package format. references/evaluation.md owns evaluation and names the upstream workflows it uses.

