GrayMatter Analytics

GrayMatter Analytics

Use this skill when a user wants analytics, KPI, report, dashboard, or semantic-context work to use GrayMatter as the product surface for memory, retrieval, receipts, and live schema awareness.

Core Rule

/v1/api-docs is the source of truth for the current RBAC-visible schema.

GrayMatter helpers may expect GrayMatter product surfaces such as memory, retrieval, receipts, status, and schema introspection when the plugin is installed and authenticated. They must not assume business objects such as Invoice, UserPreference, StrategicPriority, KeyMetric, Customer, Workflow, or Application exist until the current /v1/api-docs says they exist for this account.

Start Here

1. Ensure GrayMatter is activated or at least check status with the available GrayMatter tool or script.
2. Retrieve relevant durable context through GrayMatter memory or retrieval receipts.
3. Load or refresh /v1/api-docs before using business objects, fields, relationships, or actions.
4. Map the user question to only the object families and paths present in the live schema.
5. If schema or retrieval evidence is missing, stale, partial, or conflicting, say so and ask for the smallest useful fallback.

Source Order

1. Live /v1/api-docs for schema, paths, components, fields, relationships, and actions.
2. GrayMatter retrieval receipt for memory-backed answers, including its answer policy and coverage status.
3. Live GrayMatter memory read/query when receipts are unavailable.
4. User-provided sources such as SQL, dashboards, docs, exports, screenshots, repository files, or local semantic layers.
5. Local fallback files only when GrayMatter is unavailable or the user explicitly wants local-only work.

Business Object Rules

• Treat object families outside the GrayMatter core as conditional.
• Verify both the path/component and the specific field or relationship before using it in analysis.
• When an expected object family is missing, use the closest live schema object only if it is semantically appropriate and say why.
• Do not synthesize unavailable schema objects from examples, docs, memories, or another user's tenant.
• For high-stakes analytics, refresh schema and retrieve source evidence during the workflow, even when saved context exists.

Normalized Context Rules

Analytics quality depends on graph traversal, filters, and retrieval receipts seeing structured fields rather than blobs.

• Do not write analytics context by stuffing metadata into MemoryEntry.text or ContentData.contentData.
• Use MemoryEntry.text only for the concise durable fact, decision, todo, preference, handoff, or artifact summary.