aiskills

aiskills - AI Skills CLI

aiskills is a toolkit of curated skills for AI coding assistants. It provides skill files for Claude Code, Gemini CLI, or Codex CLI.

Each skill is a small knowledge package: a SKILL.md file with YAML frontmatter plus a set of reference files. When a prompt matches the skill, the assistant reads those files and answers from the source material.

---

Installation

Option A: Plugin Marketplace (Claude Code only)

/plugin marketplace add maccesar/aiskills
/plugin install aiskills@maccesar-aiskills

Option B: CLI (Claude Code, Gemini CLI, Codex CLI)

# 1) Install the CLI
npm install -g @maccesar/aiskills

# 2) Install skills globally
aiskills install

# 3) Start your AI coding assistant
claude   # or gemini, or codex

# 4) Ask a question that matches a skill

Installed files:

• All skills to ~/.agents/skills/
• Platform symlinks in ~/.claude/skills/ (Gemini CLI and Codex CLI auto-discover from ~/.agents/skills/ — no platform-specific symlink needed)

Which option should I use?

	Plugin (Option A)	CLI (Option B)
Claude Code	Recommended	Supported
Gemini CLI	Not available	Supported
Codex CLI	Not available	Supported
Auto-updates	Via marketplace	aiskills update

---

Compatible platforms

Platform	Status	Installation Path
Claude Code	Supported	~/.claude/skills/
Gemini CLI	Supported	~/.agents/skills/ (auto-discovered)
Codex CLI	Supported	~/.agents/skills/ (auto-discovered)

All three platforms use the same Agent Skills format: a SKILL.md file with YAML frontmatter that tells the assistant when to use the skill and what to do.

---

Available skills

Skill	Domain	Source	Reference Files
refactoring-ui	Design	"Refactoring UI" by Wathan & Schoger	7 files
humaniza	Writing (es)	Curated Spanish/es-MX style rules	7 files
vscode-extension-dev	VS Code	VS Code Extension API docs	14 files
stitch-showcase	Design Tools	Google Stitch export workflow	16 files

Use aiskills list to see available skills from the command line. Pull requests are welcome.

---

Available commands

Slash commands are Claude Code-only. They ship with the plugin (Option A). The CLI distribution (Option B) installs skills only.

Command	Purpose
/release	Full release workflow: detect project, bump semver, update CHANGELOG + README, commit, push, tag, GitHub release

/release

End-to-end release janitor that works across project types: npm, Titanium (tiapp.xml), Composer, Cargo, CocoaPods, or versionless (git-tag-only) repos. Designed for a dirty working tree — it groups your uncommitted work into semantic commits, then ships the release on top.

When to use it:

• You have weeks of work in the working tree (with maybe a few interim commits you made along the way) and want one command to clean everything into proper semantic commits and ship a release.
• You maintain CHANGELOG.md in Keep-a-Changelog format and want the [Unreleased] section promoted automatically.
• You want the bump level inferred from Conventional Commits across both your existing commits and the proposed new ones, with the option to override.

Example prompts:

/release
/release minor
/release major