AI Skills & Conventions

Reusable AI coding-assistant skills, prompts, and instructions.

Pick one:

1. Option 1: install just the Claude Code skills.
2. Option 2: use the CLI for the broader multi-tool setup.

Option 1: Install Claude Skills

This is the simplest path. Use it if you only want the SKILL.md workflows in Claude Code:

npx skills@latest add rahul-kulkarni105/skills

The installer reads .claude-plugin/plugin.json and installs the published skills from skills/.

Option 2: Use The CLI

Use this if you want everything in Option 1, plus the extra multi-tool setup:

• AGENTS.md, CLAUDE.md, and GEMINI.md entry files.
• Cursor rules and GitHub Copilot instructions.
• Codex, Gemini CLI, Windsurf, and Ollama guidance.
• Selected bundles instead of installing everything.
• Lockfile verification so installed files can be checked later.
• Bootstrap/submodule-friendly project setup.

npx @rahulkulkarniskills/ai-skills init --ref <tag-or-commit>

For local development against this checkout:

npm --prefix cli install
npm --prefix cli run build
node cli/bin/ai-skills.js init --manifest ./manifest.json

Verify installed files:

npx @rahulkulkarniskills/ai-skills verify

For debugging:

ai-skills --verbose init --manifest ./manifest.json
AI_SKILLS_LOG=debug ai-skills verify

For telemetry preferences:

ai-skills telemetry status
ai-skills telemetry enable
ai-skills telemetry disable

Telemetry consent is stored in your user config directory, not in the project. DO_NOT_TRACK=1 and AI_SKILLS_TELEMETRY=0 are respected.

Privacy

Anonymous telemetry is opt-in. Interactive init asks once; --yes, CI, and non-TTY runs stay disabled unless AI_SKILLS_TELEMETRY=1 is set. Telemetry is sent only when a PostHog project key is configured.

Telemetry never sends secrets, absolute paths, file contents, registry URLs, Git remotes, raw command arguments, user names, host names, raw error messages, or stack traces. See docs/telemetry.md for the full schema and controls.

What Is Included

• skills/ — Claude Code skills:

grill-me, convince-me, weak-spots, steelman, pre-mortem.

• AGENTS.md, CLAUDE.md, and GEMINI.md

— shared instructions for different agents.

• .github/copilot-instructions.md and

.cursor/rules/000-index.mdc — native Copilot and Cursor entry points.

• instructions/, prompts/, and stacks/

— reusable guidance, prompt templates, and stack-specific conventions.

• manifest.json and cli/ — the multi-tool installer.

Root Files

Some files stay at the project root on purpose because tools look for them there:

• AGENTS.md, CLAUDE.md, and GEMINI.md.
• README.md, LICENSE, and manifest.json.
• .claude-plugin/, .claude/, .cursor/, .github/, and .vscode/.
• skills/, instructions/, prompts/, and stacks/, because the

model-facing docs and installer manifests point at those paths.

VS Code is the primary target environment for the config folders listed above. The .github/ folder is read by the GitHub Copilot extension (GitHub/Microsoft); .claude/ by the Claude Code extension (Anthropic); .cursor/ by Cursor (Anysphere — a VS Code fork, not a VS Code extension). AGENTS.md, CLAUDE.md, and GEMINI.md are additionally read by their respective CLI tools outside VS Code.

Other Ways To Consume

• Bootstrap: copy a snapshot into a project with

bootstrap/install.sh.

• Submodule: pin this repo in a project and update it deliberately.

See docs/sync-strategies.md for the tradeoffs.

Tool Guides

• Claude Code
• Codex
• Cursor
• GitHub Copilot
• Gemini CLI
• Windsurf
• Ollama

Boundaries

This repo holds shareable, objective content (conventions, stack guidance, adversarial skills, token discipline). Personal, subjective preferences (e.g. "I like terse responses") belong in your global config: ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, ~/.gemini/GEMINI.md, Cursor user rules, Copilot personal instructions.

Project config in a consuming repo always wins over the defaults here. See docs/working-with-ai.md.

License

Dual-licensed by component type:

• Content (markdown skills, rules, instructions, prompts, stacks,

docs — everything outside cli/): CC BY 4.0. Creative Commons explicitly recommends against CC licenses for software, so the CLI is licensed separately.

• CLI code (cli/ — the TypeScript installer published as

@rahulkulkarniskills/ai-skills): MIT.