seanmars/mreq

mreq-shared

Shared files for the other mreq skills, not a task.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/seanmars/mreq --skill mreq-shared

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

mreq-shared

This skill does nothing on its own. If you are reading this file because a user asked for something, stop: nothing here is a task. Tell the user which mreq skill fits their request (/mreq-define, /mreq-how, /mreq-graph, ...) and do not use any file here.

The other mreq skills find this directory at ../mreq-shared from their own directory, and use these files by path. Each skill's SKILL.md says when to read or run them.

FileWhat it isUsed by
scripts/mreq.pyCreates, lists, updates, shows the progress of, and deletes task documents under .mreq/mreq-define, mreq-grill, mreq-apply, mreq-close
templates/One task-document template per schema; mreq.py new reads themmreq.py
scripts/page.pyBuilds and checks the offline page. Its first argument, how or graph, picks the output folder under .mreq/ and that skill's skeleton.htmlmreq-how, mreq-graph
GRILL.mdHow to grill a document or a restatement: the four quadrants, the interview rules and the limitsmreq-grill, mreq-define
MERMAID.mdHow to write a diagram figure: the markup, size, colors, Mermaid rules and the legendmreq-how, mreq-graph
vendor/pele.global.jsPele (https://pele.run/), which draws the Mermaid diagrams; page.py build inlines it in each pagepage.py
scripts/check.mjsRenders each diagram with Pele in Node, so the build sees the errors the browser would showpage.py

Never edit these files while running another skill.

from this repository

More skills

All skills
seanmars
Community

mreq-graph

Turn the user's description into Mermaid diagrams on an offline single-page HTML, each with a legend for its colors and line styles, written to .mreq/graph/ under the session root. Pele (https://pele.run/) renders the diagrams, inlined in the page so it works with no network. Covers flowcharts, sequence, state, ER, class, gantt, timeline, mindmap and other Mermaid charts. Confirms its reading of the description with the user before drawing. Use for /mreq-graph.

1h installs
1
GitHub stars
0
Updated
Nov 10
seanmars
Community

mreq-grill

Pressure-test an mreq task document under .mreq/ with a four-quadrant Known/Unknown interview, then write what it settles back into the document's Decisions, Tasks, Assumptions, and Open sections. Use when the user says "grill", "grill me", or wants to find unspoken assumptions and blind spots in a plan, or after mreq-define hands a document over.

1h installs
1
GitHub stars
0
Updated
Nov 10
seanmars
Community

mreq-how

Explain how part of the codebase works as an offline HTML page with architecture, sequence, state, and flow diagrams in Mermaid, written to .mreq/how/ under the session root. Pele (https://pele.run/) renders the diagrams, inlined in the page so it works with no network. Covers "how does X work", walkthroughs before changing something, and placement questions ("where should this live", "which layer owns this"). --plain writes it for readers who know the product by its features (planners, PMs) and

1h installs
1
GitHub stars
0
Updated
Nov 10