Initial commit

skills/ospack/SKILL.md

@@ -0,0 +1,49 @@
+# ospack - Semantic Context Packer
+
+Use ospack to gather relevant code context through import resolution and semantic search.
+
+## When to use this skill
+
+Use ospack when you need to:
+- Understand a file and all its dependencies
+- Find code related to a concept across the codebase
+- Build comprehensive context for refactoring, debugging, or feature work
+- Explore unfamiliar codebases
+
+## Commands
+
+### Pack context (recommended)
+
+Combines import resolution with semantic search:
+
+```bash
+# From a focus file
+ospack pack --focus src/auth.py --root $(pwd)
+
+# With semantic query
+ospack pack --query "error handling" --root $(pwd)
+
+# Both together (best results)
+ospack pack --focus src/api.py --query "validation" --root $(pwd)
+```
+
+### Quick search
+
+For fast semantic searches:
+
+```bash
+ospack search "database connection" --root $(pwd)
+```
+
+## Output formats
+
+- `--format xml`: Structured XML (default, best for context)
+- `--format compact`: Human-readable markdown
+- `--format chunks`: Function-level results with scores
+
+## Tips
+
+- Use `--focus` when you have a specific entry point
+- Use `--query` when searching by concept
+- Combine both for comprehensive context
+- Increase `--max-files` for larger explorations