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:

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:

{
  "provider": "gemini"
}

Note: This skill currently supports Python packages via PyPI.