SKILL.md
Knowledge Graph Context Skill
Access ChromaDB knowledge graph via coconut-knowledge-mcp.
When to Use
- Understand project architecture before changes
- Find where functionality is implemented
- Understand design decisions and rationale
- Learn component relationships
- Discover integration patterns
- Get project context
Get Collection Name
CRITICAL: Collection = {author}_{repo} from git remote.
git remote get-url origin 2>/dev/null | sed -E 's|.*[:/]([^/]+)/([^/.]+)(\.git)?$|\1_\2|' | tr '[:upper:]' '[:lower:]' | tr '-' '_'Quick Reference
Search Knowledge
chroma_query_documents(
collection_name="<collection>",
query_texts=["your question"],
n_results=5
)Filter by Type
chroma_query_documents(
collection_name="<collection>",
query_texts=["your question"],
n_results=5,
where={"type": "architecture"}
)Get Document Count
chroma_get_collection_count(collection_name="<collection>")Get Specific Documents
chroma_get_documents(
collection_name="<collection>",
ids=["component-auth-service"]
)Node Types
| Type | Description |
|---|---|
| architecture | System structure, design |
| component | Modules, services |
| workflow | Processes, data flows |
| integration | APIs, databases |
| convention | Patterns, naming |
| decision | Choices with rationale |
Search Strategies
Architecture: where={"type": "architecture"} Components: where={"type": "component"} Decisions: where={"type": "decision"}
Workflow
- Get collection name from git remote
- Check collection exists:
chromalistcollections - Search for context:
chromaquerydocuments - If stale: suggest
/coconut-knowledge:update
Add New Knowledge
Use /coconut-knowledge:add or:
chroma_add_documents(
collection_name="<collection>",
documents=["content"],
ids=["type-name"],
metadatas=[{"name": "...", "type": "...", "tags": "..."}]
)Troubleshooting
- No results: Check collection exists, try broader terms
- Stale info: Run
/coconut-knowledge:update - Not initialized: Run
/coconut-knowledge:init