putdotio/skills

Shared agent skills for put.io development workflows.

Installation

Install all shared put.io skills globally:

npx --yes skills add putdotio/skills -g --all -y

Tessl

Use Tessl to review and publish the skills in this repo to the putio workspace.

make verify
./scripts/review-skills.sh
./scripts/optimize-skills.sh frontend/frontend-dev

Per-skill checks:

./scripts/tessl.sh review run --json --workspace putio skills/frontend/frontend-dev
./scripts/tessl.sh plugin lint skills/frontend/frontend-dev
./scripts/tessl.sh plugin publish --dry-run skills/frontend/frontend-dev

Publishing from GitHub Actions expects TESSL_TOKEN in the protected release Environment. See Distribution for the publish flow and plugin naming.

Publishable skill shape

Published skills keep their package metadata next to the skill. Use Distribution as the source of truth for .tessl-plugin/plugin.json, optional agents/openai.yaml, and Tessl publishing behavior.

Docs

• Distribution for publish flow and repository release details
• Evals for scenario layout and registry Impact checks
• Security for private vulnerability reporting

Repo Internals

• Agent guide for repo-specific automation guidance
• Scripts reference for helper script notes

Contributing

Use Contributing for skill-authoring workflow and review expectations.

License

Licensed under the MIT License.