AI skills

Reusable skills for coding agents and other assistants, maintained in one place.

Install

Claude Code:

claude plugin marketplace add Okane-Works/ai-skills
claude plugin install ai-skills@OkaneWorks

Codex CLI:

codex plugin marketplace add Okane-Works/ai-skills
codex plugin add ai-skills@OkaneWorks

See installation for updates, desktop and cloud setup, Gemini, Kimi, Hermes, OpenRig, OpenCode, DeepSeek, and Grok.

Contribute

Pass private inputs through arguments, context, settings, or authenticated tools. Keep credentials and permissions in the agent's environment. The infrastructure owner manages service deployments.

Put each skill's SKILL.md and supporting files in skills/<name>/. Preserve useful source instructions and upstream attribution. Explain material changes in the pull request.

Validation

Use Python 3.11 or later in a virtual environment:

python -m pip install -r requirements-dev.txt
skills-ref validate skills/skill-writing

Check local Markdown links with Lychee:

lychee --offline --no-progress './**/*.md'

GitHub Actions checks skill format, JSON syntax, and local Markdown links on pull requests and pushes to main. Review external URLs and test skill behavior separately.

Sources

Agent Skills specification: format and metadata.
Agent Skills authoring practices: scope, context use, and learning from real tasks.
OpenAI skill guidance: creation and discovery.
Anthropic authoring guidance: concise instructions and evaluation.
skills-ref: frontmatter and naming validation.
Lychee: Markdown link checking.

Keep skill-specific sources with the skill and describe what each contributes:

Installation sources are linked beside each harness's setup instructions.