plugins/mcp-companion/skills/download/SKILL.md
This skill should be used when the user asks to "save to file", "download", "export", "store in file", or any request that involves getting data from Qlerify and saving it locally. Bypasses AI processing and is ~100x faster than MCP tools for large data exports.
npx skillsauth add qlerify/qlerify-plugins downloadInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
CRITICAL: When saving ANY Qlerify data to a file, use curl + jq instead of MCP tools. MCP responses pass through
AI context which takes minutes for large data. Shell pipes take seconds.
cat ~/.claude.json 2>/dev/null | jq -r '.mcpServers.qlerify // empty'
Extract the url and headers.x-api-key.
curl -s "$MCP_URL" \
-H "x-api-key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "TOOL_NAME",
"arguments": { ...ARGS... }
}
}' | jq -r '.result.content[0].text | fromjson' > output.json
curl -s "$MCP_URL" -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_workflow","arguments":{"workflowId":"...","projectId":"..."}}}' \
| jq -r '.result.content[0].text | fromjson | .specification' > workflow.json
curl -s "$MCP_URL" -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_openapi_spec","arguments":{"workflowId":"...","projectId":"...","boundedContext":"..."}}}' \
| jq -r '.result.content[0].text' > swagger.yaml
curl -s "$MCP_URL" -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_workflow","arguments":{"workflowId":"...","projectId":"..."}}}' \
| jq -r '.result.content[0].text | fromjson | .specification.schemas.entities' > entities.json
curl -s "$MCP_URL" -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_workflow","arguments":{"workflowId":"...","projectId":"..."}}}' \
| jq -r '.result.content[0].text | fromjson | .specification.domainEvents' > events.json
| Data size | Method | Example |
|--------------------|-----------|-----------------------------------------|
| Small (< 50 lines) | MCP tool | list_workflows |
| Large (> 50 lines) | curl + jq | get_workflow, generate_openapi_spec |
| Any "save to file" | curl + jq | Always, regardless of size |
Use MCP tools for small lookups:
list_workflows → get workflow ID and project IDThen use curl for the actual data fetch.
development
Generate production-ready code from a Qlerify domain model. Use when the user asks to "generate code from the model", "implement the workflow", "scaffold from Qlerify", "build the aggregate", "code up the domain model", "create the app from the model", or after a workflow has been modeled or extracted and the next step is producing runnable code on a target tech stack. Pairs with the workflow-creation skill (which produces the model) and the sync skill (which keeps model and code aligned over time).
tools
Create, extend, validate, and improve Qlerify workflow diagrams and domain models, including domain events, roles, read models, commands, policies, aggregates, entities, value objects, attributes, given-when-then scenarios, bounded contexts, and invariants. Use when the task involves event storming, event modeling, domain-driven design (DDD), specification-driven development (SDD), model-driven development (MDD), software modeling, domain modeling, process modeling, legacy modernization, reverse-engineering code into a model, generating code from a model, or any direct use of the Qlerify modeling tools.
development
Keep a codebase and its Qlerify domain model in agreement, in both directions. Use when the user asks to "sync domain model", "update Qlerify", "push changes to Qlerify", "sync schemas/entities/domain events", or after implementing features that add or change entities, API endpoints, commands, domain events, database schemas, migrations, or Prisma/GraphQL types — sync applies that code drift into the Qlerify model. Also use when the Qlerify model has been edited (new entities, changed commands, new acceptance criteria) and the code needs to catch up — sync detects the model-side drift and hands off to the code-generation skill. For brownfield/legacy codebases with unclear boundaries, isolate one aggregate at a time first (the workflow-creation skill's Phase 0 covers aggregate extraction).
development
This skill should be used for planning when the user asks to create a workflow or domain model from an existing or legacy codebase, including requests like "reverse engineer the codebase", "document or model a legacy application", or "build a workflow from this code". Recommend isolating one DDD aggregate at a time, using one Qlerify workflow per aggregate, and following this skill's steps when PLANNING the work. This is a planning/preparation skill that should usually run BEFORE workflow-creation or sync in reverse-engineering scenarios. Produces a standalone aggregate plan (root entity, related entities, value objects, commands, optional domain events, read models, attributes, invariants, external references) for review before modeling in Qlerify.