Skill io contract skill
Local-first IO contract checker for reusable agent skillsFrom the repository description
npx -y skills add rogerchappel/skill-io-contract-skillAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.2 KB, 250 tokens by cl100k_base, as published. Nobody here has run it
Skill IO Contract
When to Use
Use this skill when preparing, reviewing, or releasing an agent skill and you need proof that the skill states its input and output contract clearly.
Required Inputs
- Path to a
SKILL.mdfile. - Optional JSON fixture file containing example cases.
- Optional output path for the generated Markdown report.
Outputs
- A Markdown report containing a pass/fail result and check score.
- An optional report file when
--reportis provided.
Side-Effect Boundaries
This skill is read-only for source artifacts. It may write a report file only when the user or automation explicitly provides --report.
Approval Requirements
External account writes, package publishing, repository pushes, or live connector actions are outside this skill. Ask for explicit approval before taking those actions in a separate workflow.
Examples
skill-io-contract check --skill SKILL.md --fixtures fixtures/cases.json
skill-io-contract check --skill ../my-skill/SKILL.md --report io-contract.md
Validation Workflow
Run npm test, npm run check, and npm run smoke. Attach the generated report to the release-candidate PR.
What ships with it: 20 files
26.3 KB alongside SKILL.md, 6 of them executable
docs/
- FIXTURE_SCHEMA.md1.1 KB
- ORCHESTRATION.md572 B
- PRD.md831 B
- RELEASE_CANDIDATE.md261 B
- RELEASE_VALIDATION.md398 B
- TASKS.md281 B
fixtures/
- bad-cases.json308 B
- cases.json411 B
scripts/
- validate.shruns214 B
src/
- skill_io_contract/checker.pyruns7.8 KB
- skill_io_contract/cli.pyruns996 B
- skill_io_contract/__init__.pyruns151 B
- skill_io_contract/__main__.pyruns80 B
tests/
- test_checker.pyruns9.1 KB
- CONTRIBUTING.md222 B
- .gitignore70 B
- LICENSE1.0 KB
- package.json401 B
- pyproject.toml527 B
- README.md1.7 KB