Knowledge Graph Reflector FAQs

Question 1

What is the Reflect skill in Claude Code?

Accepted Answer

The Reflect skill is a specialized tool that analyzes text files to identify conceptual relationships, creating a connected knowledge graph by updating Maps of Content (MOCs) and adding bidirectional links.

Question 2

What is the 'Articulation Test' used by this skill?

Accepted Answer

The Articulation Test is a quality control mechanism where the skill must be able to explicitly state *why* two notes relate (e.g., 'X extends Y' or 'A contradicts B') before a connection is approved.

Question 3

Does this skill require specific directory structures?

Accepted Answer

While it has defaults, it is highly configurable via a derivation-manifest.md file, allowing you to define custom folder names for notes, inboxes, and topic maps.

Question 4

How does the Reflect skill find connections?

Accepted Answer

It uses a dual-discovery method that explores existing topic maps while simultaneously running semantic vector searches to find conceptual neighbors that might not share the same keywords.

Question 5

Can Reflect perform semantic search without external tools?

Accepted Answer

It prefers MCP tools like mcp__qmd for deep search but features a robust fallback system that can utilize bash-based queries or standard grep if specialized indexing tools are unavailable.

Knowledge Graph Reflector

Key Features

Use Cases

Knowledge Graph Reflector

Key Features

Use Cases