writing-workflow-skills SKILL.md skillA
writing-workflow-skills from jetbrains/thinkrail is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jetbrains/thinkrail/writing-workflow-skills@git:20260716.444e9e4Pins git:20260716.444e9e4 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jetbrains/thinkrail
- Path
packages/pi-thinkrail-workflow/skills/writing-workflow-skills/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260716.444e9e4, committed Jul 16, 2026
- First version recorded
- Jul 13, 2026
- Size
- 7,587 bytes
- Repository stars
- 7,127
- License
- Apache-2.0
Use when adding a new workflow skill to pi-thinkrail-workflow, changing an existing workflow skill's role, trigger, handoff, or structure, or checking a workflow skill against the workflow system's rules. Not for authoring general-purpose skills outside this package.
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
# Writing Workflow Skills
The authoring checklist for workflow skills in `packages/pi-thinkrail-workflow`. It carries the *what
to do*; every *why* — the concept model, the three roles, the meta-rules cited as "(rule N)" below —
lives once in the workflow-system spec beside this directory, **`skills/SPEC.md`**. Read that spec
first; where this checklist and that spec disagree, the spec wins.
**Workspace guard.** This checklist edits `packages/pi-thinkrail-workflow` in the thinkrail repo. If
that package is not in the current workspace (a ThinkRail-managed project, where these skills are a
read-only staged cache), the family cannot be extended from here: say so in one line and stop — the
terminal state for foreign workspaces.
## Design (before writing)
- [ ] Read `skills/SPEC.md`: concept model, the three roles, meta-rules 1–15.
- [ ] Scope the skill to one externally reachable workflow — or, for a concept, one topic (rule 1).
Internal forks, branches, stages, and shared tails are sibling docs, planned with the choice
rules in the doc (or spine) before the fork; a doc is promoted to its own skill when it needs
…Read the whole file at its exact version.
How to install
mdr add jetbrains/thinkrail/writing-workflow-skills@sha256:4373707e66e76a58The line at the top of this page pins the label git:20260716.444e9e4, 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_nfawzg6ui6ixoqpm)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jul 13, 2026 and Jul 16, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260716.444e9e4 latest | 2026-07-16 | 444e9e4 | 7,587 B | A | view · diff |
| git:20260713.f2e4d5a | 2026-07-13 | f2e4d5a | 7,508 B | A | view |
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 (7587 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
jetbrains/thinkrail · 7,127 stars · license Apache-2.0 · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_nfawzg6ui6ixoqpm GET https://markdownregistry.com/api/v1/resolve?ref=jetbrains/thinkrail/writing-workflow-skills GET https://markdownregistry.com/api/v1/blob/4373707e66e76a581e9aa1df18e2e34b58892531929cd986c7713c4549d9a204
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.