Create a Model
The /semantic-model-analyst agent skill builds a semantic model with you, the way a senior analyst would: interview, propose, confirm, write. The output is a single self-contained markdown file describing entities, fields, and relationships, ready for the Deploy step.
When to Use It
Trigger this skill whenever you need a data-backed system of any kind: a CRM, a helpdesk, an HRIS, a custom internal tool, or anything you would otherwise spec on a whiteboard. The skill handles greenfield modeling, mirroring well-known SaaS schemas (Salesforce, Zendesk, ServiceNow, HubSpot, Jira, and others), and reviewing or extending models that already exist.
Create a New Model
Tell the skill what you want to model. Be as terse or as detailed as you like, the skill asks follow-up questions:
/semantic-model-analyst I need a CRM for a 50-person SaaS sales team /semantic-model-analyst spec out a helpdesk for an internal IT department /semantic-model-analyst design a model for tracking field service jobs and technician schedules How a Session Goes
- Capture the system. The skill asks what you want to model and pulls the domain category (CRM, ITSM, HRIS, ERP, and so on) from the conversation.
- Pick a naming style. For well-known categories, you choose between an agent-optimized schema (self-describing names that LLMs can reason about) or a vendor-template schema (mirrors a specific incumbent, makes data migration trivial).
- Confirm the entity list. The skill drafts 6 to 15 entities with one-line purposes. You add, rename, merge, or drop any of them.
- Confirm the fields. For each entity the skill proposes a field table (name, format, required, label, references). You iterate until it matches the domain.
- Save the model. The skill writes a
*-semantic-model.mdfile with the right front-matter, an entity-relationship diagram in Mermaid, an enumerations section, and implementation notes.
The output file is portable. Pass it to the Deploy skill to ship it to a live Semantius instance, hand it to a teammate for review, or run Optimize later to pull a freshly-edited live module back into a markdown spec.
Customize or Extend an Existing Model
The same skill audits a model file (flagging blockers, warnings, and suggestions against the Semantius platform constraints) and extends it (adding entities, fields, or relationships without breaking what is already there). Point it at any *-semantic-model.md, including one of the Templates you pulled down:
/semantic-model-analyst customize ./crm-semantic-model.md, I want to drop campaigns and add a renewals entity /semantic-model-analyst customize https://www.semantius.com/models/saas_expense_tracker-semantic-model.md /semantic-model-analyst audit ./helpdesk-semantic-model.md /semantic-model-analyst extend ./hris-semantic-model.md with a time-off tracker Get the Skill
Install the Semantius CLI and the agent skills bundle to add this skill to your agent.