Obscure Package Master#

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.

Trigger Scenarios#

• You are working with a library that is not in your top-tier training set (e.g., NOT numpy, pandas, requests).
• You find yourself searching for basic API signatures or parameters for a library.
• You have a >= 5% uncertainty about a package's API behavior or structure.
• The package's documentation is sparse or confusing.

Instructions#

When the trigger conditions are met, follow these steps to generate a grounded reference for the package:

1. Identify the Package & Version: Determine the package name and the exact version you need (e.g., from requirements.txt, pyproject.toml, or pip show).

2. Run the Generator: Execute the generate_mirror.py script to create a local skill for that specific package version. bash

   python3 <path_to_scripts>/generate_mirror.py <package> <version>
   
   

3. Activate the New Skill: Once generated, a new skill will be available in .skills/<package>-<version>.

4. 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.

5. Targeted Reading: Use the map to perform surgical read_file calls on the files in the references/ directory of the new skill.

   • Example: "I see MyClass.my_method is in references/utils.py lines 120-145. I will read those lines now."

Core Principles#

• Deterministic: The map is a direct reflection of the source code (AST-parsed). No LLM interpretation is involved in building the map.
• Coordinate System: Use the provided line ranges to avoid reading large files. Only grep exactly what you need.
• Grounding: If the package source is available, there is no excuse for API hallucinations.

Provider Compatibility#

This skill is designed to work with any AI agent provider that can execute Python scripts. The output location is configurable for each provider:

ProviderDefault skills pathAuto-detected via env var(s)Claude~/.claude/skills``ANTHROPIC_API_KEY, CLAUDE_API_KEYGemini~/.gemini/skills``GEMINI_API_KEY, GOOGLE_GENERATIVEAI_API_KEYCodex~/.copilot/skills``CODEX_API_KEY, GITHUB_COPILOT_TOKENCursor~/.cursor/skills—OpenAI~/.openai/skills``OPENAI_API_KEYOpenClaw~/.openclaw/skills—Cline~/.cline/skills—

Configuration priority (highest wins):

1. AGENT_SKILLS_PATH environment variable
2. skills_path in config.json
3. Provider-specific default (auto-detected or set via provider in config.json / AGENT_PROVIDER env var)
4. .skills/ in the current working directory

Example config.json for explicit provider selection:

json

{
  "provider": "gemini"
}

---

Note: This skill currently supports Python packages via PyPI.