putdotio/skills

Shared agent skills for put.io development workflows.

Installation

npx skills add putdotio/skills

Install one skill directly:

npx skills add https://github.com/putdotio/skills --skill putio-frontend-docs

Tessl

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

./scripts/review-skills.sh
./scripts/optimize-skills.sh frontend/docs

Per-skill checks:

./scripts/tessl.sh skill review --json skills/frontend/docs
./scripts/tessl.sh tile lint skills/frontend/docs
./scripts/tessl.sh tile publish --dry-run skills/frontend/docs

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

Publishable skill shape

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

Docs

• Contributing for contributor workflow and validation
• Distribution for publish flow and repository release details
• 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.