piker/ai

AI Tooling Integrations

Documentation and usage guides for AI-assisted development tools integrated with this repo.

Each subdirectory corresponds to a specific AI tool or frontend and contains usage docs for the custom skills/prompts/workflows configured for it.

Originally introduced in PR #69; track new integration ideas and proposals in issue #79.

Integrations

Tool	Directory	Status
Claude Code	claude-code/	active
OpenCode	opencode/	active

Shared Skills

Repo-specific skills use the portable Agent Skills frontmatter subset and live under .claude/skills/ as a single source. Claude Code discovers that directory natively, and OpenCode discovers the same project skills without copies or generated wrappers.

Harness-specific command files should only delegate to a shared skill. They must not duplicate the skill body.

Adding a New Integration

Create a subdirectory named after the tool (use lowercase + hyphens), then add:

1. A README.md covering setup, available skills/commands, and usage examples
2. Any tool-specific config or prompt files

ai/
├── README.md                  # <- you are here
├── claude-code/
│   └── README.md
├── opencode/
│   └── README.md
└── <your-tool>/
    └── README.md

Conventions

• Skill/command names use hyphen-case (commit-msg, not commit_msg)
• Each integration doc should describe what the skill does, how to invoke it, and any output artifacts it produces
• Keep docs concise; link to the shared skill source files rather than duplicating content
• Keep skill bodies harness-neutral; isolate slash-command syntax and permissions in each harness integration