Build skills for OpenKiln — the open-source agentic GTM data workflow CLI.

This repo provides everything needed to create, validate, and submit OpenKiln skills:

• SKILL-SPEC.md — the canonical specification for what makes a valid skill
• AGENTS.md — step-by-step instructions for LLM agents building skills
• templates/ — annotated starter files for each component
• examples/ — reference implementations (OrbiSearch, minimal)
• validate/ — validation CLI to check a skill against the spec
• skill.schema.json — JSON Schema for the skill manifest

1. Point your agent at this repo
2. Give it an API spec or docs URL for the integration you want
3. The agent reads AGENTS.md and builds the skill
4. Validate: python validate/validate.py ./your-skill/
5. Submit a PR to the skills directory

1. Read SKILL-SPEC.md to understand the contract
2. Copy templates/ as a starting point
3. Study examples/orbisearch/ as a reference implementation
4. Validate: python validate/validate.py ./your-skill/

A skill is a Python package that extends OpenKiln with new data sources, transforms, or sinks. Skills:

• Live in openkiln/skills/<name>/ in the OpenKiln CLI repo
• Own their own SQLite database (~/.openkiln/skills/<name>.db)
• Optionally provide CLI commands (mounted as openkiln <name> ...)
• Interact with other skills only through the database attach layer — never through Python imports
• Are installed via openkiln skill install <name>

MIT