Skip to content
appsgit

Writing Specs

Writing Specs is an agent skill (a SKILL.md file) from JetBrains/thinkrail. Agents load it when a workflow step drafts or revises a spec artifact — a goal-and-requirements, an architecture, or a module SPEC — or when a workflow skill… It works with Claude Code and Codex and has 8,297 GitHub stars across a repository of 3 listed skills.

github.com/JetBrains/thinkrail/packages/pi-thinkrail-workflow/skills/writing-specs (opens in a new tab)

Data as of from the GitHub API; description from the skill's SKILL.md. Report an error

Add this skill

Claude

Claude Code loads skills from ~/.claude/skills/ (all projects) or .claude/skills/ (one project):

git clone --depth 1 https://github.com/JetBrains/thinkrail.git
cp -r thinkrail/packages/pi-thinkrail-workflow/skills/writing-specs ~/.claude/skills/writing-specs   # personal, or .claude/skills in a project

In the Claude apps, zip the writing-specs folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

ChatGPT / Codex

Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:

git clone --depth 1 https://github.com/JetBrains/thinkrail.git
cp -r thinkrail/packages/pi-thinkrail-workflow/skills/writing-specs .agents/skills/writing-specs   # repo; ~/.agents/skills for all projects

Standalone skills also load in the ChatGPT desktop app.

Cursor

Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:

git clone --depth 1 https://github.com/JetBrains/thinkrail.git
cp -r thinkrail/packages/pi-thinkrail-workflow/skills/writing-specs .cursor/skills/writing-specs   # project; ~/.cursor/skills for all projects

Source (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)

What this skill does

Use when a workflow step drafts or revises a spec artifact — a goal-and-requirements, an architecture, or a module SPEC — or when a workflow skill names it at such a step. The shared quality bar for specs — not a workflow, nothing to execute. The workflow family's shared bar for every spec a workflow produces: short, honest, on-rails. Process skills name this concept at the steps that draft or revise specs; what to draft and when stays with the referencing skill.

When it triggers

  • Use when a workflow step drafts or revises a spec artifact — a goal-and-requirements, an architecture, or a module SPEC — or when a workflow skill names it at such a step.

More skills in JetBrains/thinkrail

3 skills are listed from this repository.

Similar skills

More docs & writing skills

All Docs & writing

FAQ

Writing Specs FAQ

Still curious? Email info@appsgit.com.

How do I install the Writing Specs skill?

Copy the writing-specs folder (the one containing SKILL.md) into ~/.claude/skills/ for Claude Code, .agents/skills/ for Codex or .cursor/skills/ for Cursor. The agent picks it up automatically when a task matches its description.

Is the Writing Specs skill free?

Yes. The repository is open source under the Apache-2.0 license.

Is Writing Specs maintained?

The repository's most recent commit was on Nov 16, 2026. Its latest release is v0.4.0. appsgit only lists skills from repositories with a commit in the last six months.