semantic-analyst SKILL.md skillA
semantic-analyst from sidequery/sidemantic is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add sidequery/sidemantic/semantic-analyst@git:20260821.d770ce1Pins git:20260821.d770ce1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- sidequery/sidemantic
- Path
plugins/sidemantic/skills/semantic-analyst/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260821.d770ce1, committed Aug 21, 2026
- Size
- 3,927 bytes
- Repository stars
- 140
- License
- AGPL-3.0
Answer analytical, KPI, metric, trend, cohort, and business-performance questions through a Sidemantic semantic layer. Use when asked to analyze data, explain why a metric changed, compare segments or periods, calculate a business measure, or explore warehouse data when Sidemantic MCP tools or semantic model files are available. Discover and reuse trusted definitions, distinguish durable semantic-model gaps from one-off query logic, and prefer semantic queries over duplicated raw SQL.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Semantic Analyst Use the semantic layer as accumulated business knowledge, not merely as a convenient query interface. ## Workflow 1. Search the semantic catalog for the user's concepts. Search by business terms and likely synonyms; do not dump the full graph unless search is unavailable or broader topology is necessary. 2. Explain candidate metrics and inspect the relevant models. Check descriptions, dependencies, filters, aggregation or formula, grain, relationships, source file, and provenance before deciding that a metric matches the request. 3. Translate the question into existing metrics, dimensions, segments, time grains, and one-off filters. Validate uncertain field combinations. 4. Prefer a structured semantic query. Use semantic SQL only when the structured query cannot express a needed operation. Use raw warehouse SQL only for genuinely exploratory work outside the modeled surface, and label that result as outside the semantic layer. 5. Check the result for the requested grain, units, time range, exclusions, null behavior, and denominator. State material assumptions. …
Read the whole file at its exact version.
How to install
mdr add sidequery/sidemantic/semantic-analyst@sha256:4f1262b61ebfa8cfThe line at the top of this page pins the label git:20260821.d770ce1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_tlxydknlceduvkuo)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Aug 21, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3927 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
sidequery/sidemantic · 140 stars · license AGPL-3.0 · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_tlxydknlceduvkuo GET https://markdownregistry.com/api/v1/resolve?ref=sidequery/sidemantic/semantic-analyst GET https://markdownregistry.com/api/v1/blob/4f1262b61ebfa8cfc55bd0c3fe8fccccd4f3b0d2c7c460af5258819fe41dd9c5
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.