Use this skill if your uncertainty with a package's API is > 5% to create a deterministic, versioned mirror of the package repo with a built-in coordinate system, installed as an additional skill.
This skill allows you to ground yourself in the objective reality of a package's source code by generating a deterministic "grep map" and a local mirror of its source.
numpy, pandas, requests).When the trigger conditions are met, follow these steps to generate a grounded reference for the package:
Identify the Package & Version: Determine the package name and the exact version you need (e.g., from requirements.txt, pyproject.toml, or pip show).
Run the Generator: Execute the generate_mirror.py script to create a local skill for that specific package version.
python3 <path_to_scripts>/generate_mirror.py <package> <version>
Activate the New Skill: Once generated, a new skill will be available in .skills/<package>-<version>.
Use the Grep Map: Read the SKILL.md of the newly created skill. It contains a map of all classes and functions with their exact line ranges.
Targeted Reading: Use the map to perform surgical read_file calls on the files in the references/ directory of the new skill.
MyClass.my_method is in references/utils.py lines 120-145. I will read those lines now."This skill is designed to work with any AI agent provider that can execute Python scripts. The output location is configurable for each provider:
| Provider | Default skills path | Auto-detected via env var(s) |
|---|---|---|
| Claude | ~/.claude/skills | ANTHROPIC_API_KEY, CLAUDE_API_KEY |
| Gemini | ~/.gemini/skills | GEMINI_API_KEY, GOOGLE_GENERATIVEAI_API_KEY |
| Codex | ~/.copilot/skills | CODEX_API_KEY, GITHUB_COPILOT_TOKEN |
| Cursor | ~/.cursor/skills | — |
| OpenAI | ~/.openai/skills | OPENAI_API_KEY |
| OpenClaw | ~/.openclaw/skills | — |
| Cline | ~/.cline/skills | — |
Configuration priority (highest wins):
AGENT_SKILLS_PATH environment variableskills_path in config.jsonprovider in config.json / AGENT_PROVIDER env var).skills/ in the current working directoryExample config.json for explicit provider selection:
{
"provider": "gemini"
}
Note: This skill currently supports Python packages via PyPI.