skillmama

See it in action

📖 Build-in-public series on Dev.to:

Part 1 — scoring formula, 5-tier search, end-to-end example. Part 2 — security gate, SQP rules, companion skills. Part 3 — project scanner, Flow B, gap analysis. Part 4 — Phase 1.5, constraint confirmation in Flow A. Part 5 — tested my own install instructions, found they were wrong. Part 6 — eval harness, trigger-classification tests, bugs found by testing instead of assuming. Part 7 — paired skill-on/skill-off ablation, the deployment persistence check it exposed, and the live CVE it later caught. Part 8 — building the live OSV.dev and npm publisher-continuity checks, and the real CVE that proved them.

Install

Known upstream bug — read this first. For Codex and Antigravity, npx skills add ... -g prints Done! and exits 0 while writing to a directory the agent doesn't read (~/.agents/skills/ through v1.5.22; upstream main has since moved Antigravity's target to ~/.gemini/antigravity/skills, equally unread). Re-verified against skills@1.5.23 (latest) and upstream main on 2026-08-31. Root cause is isUniversalAgent(): agents whose project dir is .agents/skills get misclassified, and their globalSkillsDir is discarded. Tracked in #1060 and #1470; fixes still open as of 2026-08-31 — PR #1483 and the newer, more targeted PR #2028. 13 agents are affected.

Until one of those merges and ships in a released CLI version, copy the file yourself using the per-agent instructions below. Each one is two lines and lands in the directory that agent actually reads.

Optional — install and verify in one command

skill-land does every agent at once and exits non-zero if the file didn't land:

npx skill-land Magithar/SKILLmama --for claude-code,codex,antigravity
npx skill-land Magithar/SKILLmama --for codex --verify

Not required. The copy commands below work on their own.

Claude Code

The upstream CLI works correctly for Claude Code:

npx skills add Magithar/SKILLmama -a claude-code -g

Installs to ~/.claude/skills/skillmama/. Pass -a claude-code explicitly: without it the CLI auto-detects the calling agent from the environment, so running it from inside another agent's shell installs to that agent instead.

Then type /skillmama in any Claude Code session.

Claude.ai (Web / Desktop)

1. Clone or download this repo
2. Zip the skillmama/ folder:

   zip -r skillmama.zip skillmama/
   

3. Go to Customize → Skills → + and upload skillmama.zip
4. Type /skillmama in any Claude.ai conversation

OpenAI Codex

Codex has a native global skills directory, ~/.codex/skills/. The upstream CLI does not write there (see the bug notice above), so copy it yourself:

mkdir -p ~/.codex/skills/skillmama
curl -sL https://raw.githubusercontent.com/Magithar/SKILLmama/main/skillmama/SKILL.md \
  -o ~/.codex/skills/skillmama/SKILL.md

Then ask naturally: codex "find me the best job queue for this project".

Antigravity

Global skills live in ~/.gemini/config/skills/, which is shared by all three Antigravity surfaces (2.0, IDE, and the agy CLI) since Google consolidated their config. Confirmed by live testing here and independently in #1470, including extraction from the agy binary's own embedded docs.

mkdir -p ~/.gemini/config/skills/skillmama
curl -sL https://raw.githubusercontent.com/Magithar/SKILLmama/main/skillmama/SKILL.md \
  -o ~/.gemini/config/skills/skillmama/SKILL.md

Fully restart Antigravity (skills load at startup), then ask "Which skills are installed?" to confirm. SKILLmama should appear in the list and in the / command picker.

For a project-scoped install instead, put it in <workspace>/.agents/skills/skillmama/SKILL.md.

Usage — invoke explicitly, confirmed working via live testing: type / and select SKILLmama from the picker (or type SKILLmama before your request), then your capability question:

SKILLmama find me the best vector database for a Python project

This triggered the real pipeline in testing — a Phase 1.5 constraint question ("do you have any specific constraints or preferences? ... Reply 'none' to search with no filters"), not a generic answer. Plain natural-language prompts with no explicit SKILLmama invocation were not confirmed to auto-trigger the skill — invoke it explicitly for reliable results.

Per Antigravity's official Agent Skills docs, the agent is also supposed to auto-trigger relevant skills from context alone, without explicit invocation — driven by the skill's description: frontmatter. We haven't verified that mode here (only explicit invocation was tested), so treat auto-trigger as unconfirmed and invoke explicitly for now.

⚠️ npx skills add Magithar/SKILLmama -a antigravity -g reports success but writes to ~/.agents/skills/, which Antigravity never reads. Still reproduces on skills@1.5.22 (2026-08-08). See the bug notice at the top of Install.

Usage

/skillmama ← scans your project and asks what to find
/skillmama find me a vector database for my FastAPI project
/skillmama what auth library should I use for my Next.js app?
/skillmama find a .dwg parser for Node.js

AI Adapters

One file, skillmama/SKILL.md, runs on every platform. Only the install location differs.

Project-scoped installs go in .claude/skills/ for Claude Code and .agents/skills/ for Codex and Antigravity.

Notes:

• The ❌ rows are the upstream bug described at the top of Install, not a problem with this skill. Verified against skills@1.5.22 on 2026-08-08; re-verified against skills@1.5.23 and upstream main on 2026-08-31 — still unfixed, fix PRs #1483/#2028 both open.
• The skills CLI only discovers files named SKILL.md. Repos that ship per-platform variants under other names are invisible to it.
• Claude.ai is not CLI-installable. Zip the skillmama/ folder and upload via Customize → Skills.

Core Workflow