




SKILLmama eliminates the hours spent researching which library, SDK, or tool to use — it scans your project's actual stack, searches across 4 tiers of the ecosystem plus a companion-skills pass, and returns the top 3 ranked picks with scored evidence. No more Reddit threads or outdated blog posts; just the right tool for your exact setup, with install commands and links, in seconds.
Works with Claude Code, Claude.ai, OpenAI Codex, and Antigravity.
Demo • Install • Usage • AI Adapters • Core Workflow • Ranking Formula • 4-Tier Search • Output Format • Example • Project Structure • Packages • Evals • Roadmap • Stickers
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.
Part 9 — the mechanical/judgment boundary, the conformance test, and the crates.io extension.
Install
| Agent | How |
|---|
| Claude Code | npx skills add Magithar/SKILLmama -a claude-code -g |
| Claude.ai | Zip skillmama/ and upload it under Customize → Skills (steps) |
| OpenAI Codex | Copy one file into ~/.codex/skills/ (steps) |
| Antigravity | Copy one file into ~/.gemini/config/skills/ (steps) |
Codex and Antigravity need the manual copy because of an upstream CLI bug
(details).
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)
- Clone or download this repo
- Zip the
skillmama/ folder:
zip -r skillmama.zip skillmama/
- Go to Customize → Skills → + and upload
skillmama.zip
- 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 (why), 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".
Codex was live-tested on 2026-09-27 with an explicit /skillmama invocation.
The run scanned this repository, asked for constraints, searched all four tiers
plus companion skills, produced scored results, and reported unavailable
security evidence as unverified rather than claiming a pass.
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.7.6
(2026-11-06). See why.
Optional — install and verify in one command
skill-land installs to several agents in one command 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 above work on their own.
Why Codex and Antigravity need a manual copy
For Codex and Antigravity, npx skills add ... -g prints Done! and exits 0 while writing
to ~/.agents/skills/, a directory neither agent reads. Re-verified on skills@1.7.6, the latest
release, on 2026-11-06.
The root cause is
isUniversalAgent(): agents
whose project dir is .agents/skills get misclassified, and their globalSkillsDir is discarded.
13 agents are affected.
Tracked in #1060 and
#1470. Two proposed fixes,
PR #1483 and
PR #2028, were closed without merging
(checked 2026-11-06).
Until a released CLI version fixes this, copy the file yourself using the per-agent instructions
above. Each one is two lines and lands in the directory that agent actually reads.
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
Without an agent, the skillmama CLI runs the deterministic checks:
npx skillmama scan
npx skillmama check lodash --version 4.17.15
AI Adapters
One file, skillmama/SKILL.md, runs on every platform. Only the install
location differs.
| AI System | Global skill directory | npx skills add -g | skill-land |
|---|
| Claude Code | ~/.claude/skills/skillmama/ | ✅ correct | ✅ |
| OpenAI Codex | ~/.codex/skills/skillmama/ | ❌ writes to ~/.agents/skills/ | ✅ |
| Antigravity | ~/.gemini/config/skills/skillmama/ | ❌ writes to ~/.agents/skills/ | ✅ |
| Claude.ai | n/a, upload only | n/a | n/a |
Project-scoped installs go in .claude/skills/ for Claude Code and .agents/skills/ for Codex
and Antigravity.
Notes:
- The ❌ rows are the upstream bug, not a problem
with this skill. Verified against
skills@1.5.22 on 2026-08-08; re-verified on skills@1.7.6 on
2026-11-06 — still unfixed.
- 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