К основному содержанию
скилл CX Codex

absolute-spec — скилл для Claude Code: спецификация без сборки

Скилл absolute-spec для Claude Code превращает запрос на функцию в проектную спецификацию после изучения кодовой базы. Агент задаёт несколько уточняющих вопросов, записывает документ в docs/plans/ и передаёт его на отдельную оценку.

MIT 176 установок ★ 224 обновлён 2026-10-26

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dhruvjainin/absolute --skill absolute-spec -a claude-code
Открыть на GitHub

Что делает absolute-spec

Скилл изучает проект, уточняет решения, которые нельзя вывести из кода, и создаёт документ с описанием дизайна. Затем отдельный субагент оценивает спецификацию по полноте, согласованности, ясности, границам задачи и проверяемости. На этом работа останавливается: код не пишется, задачи на доске не создаются, коммита нет.

Файл сохраняется в <specDir>/YYYY-MM-DD-<topic>-design.md; по умолчанию используется docs/plans/, а specDir можно задать в конфигурации. Для структуры и правил проверки скилл загружает references/spec-writing.md из absolute-work. Вопросы ограничены этапом уточнения; если попросить набросок без вопросов, предположения попадут в раздел открытых вопросов. Без конфигурации скилл предлагает запустить init.

Какие задачи решает

  • подготовить спецификацию функции до начала разработки
  • сверить проектные соглашения и существующий код перед проектированием
  • передать команде документ с решениями и открытыми вопросами
  • получить независимую оценку полноты и ясности спецификации

Примеры запросов агенту

  • Подготовь спецификацию для новой функции, пока не пиши код.
  • Составь проектный документ по этой идее и передай его на независимую оценку.
  • Сделай спецификацию для передачи другому разработчику, без реализации.

Как установить absolute-spec

1Через Skills CLI (Vercel)

npx skills add dhruvjainin/absolute --skill absolute-spec -a claude-code

2Вручную: положить файлы

~/.claude/skills/absolute-spec/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/absolute-spec/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об absolute-spec

Как установить absolute-spec в Claude Code?

Запусти npx skills add dhruvjainin/absolute --skill absolute-spec -a claude-code. Файл скилла появится по пути ~/.claude/skills/absolute-spec/SKILL.md.

Что делает absolute-spec?

Он изучает кодовую базу, задаёт уточняющие вопросы и записывает проектную спецификацию. Затем отдельный субагент оценивает документ, а скилл останавливается без реализации.

Чем absolute-spec отличается от absolute-work?

absolute-spec готовит документ и завершает работу. absolute-work продолжает процесс до реализации; готовую спецификацию можно передать ему.

Исходный текст

SKILL.md · MIT
---
name: absolute-spec
version: 0.5.0
description: >
  Lightweight standalone design spec for AI coding agents: codebase scan → bounded
  clarify pass (3–5 questions, not a grill) → reviewed design doc written to
  docs/plans/ → independent scored review → stop. No task board, no build.
  Use when you want a spec to discuss, hand off, or review before committing to
  implementation. Chains into absolute-work when ready to build.
  Triggers on "absolute spec", "write a spec", "spec out this feature",
  "draft a design doc", "I want a spec to hand off / review, don't build it yet".
category: workflow
tags:
  - workflow
  - spec
  - specification
  - planning
  - design
platforms:
  - claude-code
  - gemini-cli
  - openai-codex
  - mcp
user-invocable: true
argument-hint: "[target]"
license: MIT
maintainers:
  - github: maddhruv
---

> Start your first response with the 📋 emoji.

## Absolute Spec

Absolute Spec turns a fuzzy intent into a **reviewed design-spec document** — then
stops. It is the planning artifact of `work`, lifted out of the full lifecycle: scan
the codebase, ask only the questions the code can't answer, write the spec, run an
independent scored review, and hand back a doc you can discuss, hand off, or feed into
`/absolute work` to build.

It is deliberately **lightweight**. No relentless interview, no task board, no
decompose, no execution. One deliverable: a spec good enough that an unfamiliar
developer could build from it.

---

## When to use this command

**Use `spec` when:**
- You want a design spec to **discuss, review, or hand off** — not build right now.
- You need to think a feature through on paper before committing to implementation.
- A teammate or another agent will do the building from your spec.
- You want a fast, reviewed design doc without the full phase-gated lifecycle.

**Do NOT use `spec` when:**
- You want to **design AND build** in one flow → use **`/absolute work`** (spec is its
  Phase 2, followed by decompose + safe-wave execution).
- You're documenting code that **already exists / already shipped** → use
  **`/absolute docs`** (reference/explanation docs, not a forward design).
- The change is a one-line obvious fix needing no design.

The line vs `work`: **`spec` produces a doc and stops; `work` produces a doc and then
builds it.** If you're unsure whether you'll build it now, start with `spec` — you can
chain into `work` afterward and it will pick the spec up.

---

## Key Principles

1. **Codebase before questions.** Read what exists first; ask only what code can't answer.
2. **Bounded, not relentless.** A short clarify pass (3–5 questions), not the depth-first
   grill `work` runs. Batching questions is fine.
3. **The spec is the deliverable.** Quality matters more here than anywhere — keep the
   independent scored review.
4. **Reuse, don't reinvent.** Template, scaling rules, and review rubric come from
   `absolute-work`'s `references/spec-writing.md`. This command is the thin flow around them.
5. **Stop after review.** No code, no board, no execution. Hand off cleanly.
6. **Never auto-commit.** Write the spec file and report; the user commits.

---

## The Flow

```
SCAN ─→ CLARIFY ─→ WRITE ─→ REVIEW ─→ HANDOFF
```

No hard gates between steps (that's `work`). The one checkpoint is the clarify pass —
ask, get answers, then proceed straight through to a reviewed spec.

---

### Step 1 — SCAN

Ground the spec in reality before asking anything.

1. **Convention detection** — read cached config first: if `.absolute.config.json` or
   `~/.absolute/config.json` exists (from `/absolute init`), resolve the effective config
   (project file → global `projects["<cwd>"]` → global `defaults`) and use its `conventions`,
   detecting only what's missing. No config → soft-suggest `init` and run `work`'s Codebase
   Convention Detection table (package manager, language/runtime, test runner, linter, build
   system, directory conventions; see `absolute-work`'s SKILL.md under *Codebase Convention
   Detection*). The spec must speak the project's real stack, scripts, and paths.
2. **Deep context scan** — read what exists: `docs/` (README first), root `README.md`,
   `CLAUDE.md`, `CONTRIBUTING.md`, `docs/plans/` (overlapping/related designs), recent
   commits (last 10–20), package manifests, and the directories the feature touches.
3. **Synthesize** — state what you learned in 2–4 lines (stack, relevant existing code,
   any overlapping prior design). Do not dump a file listing.

Detect the work **type** (feature / refactor / greenfield / migration) only enough to
shape the spec — `spec` does not run the full per-type question banks.

---

### Step 2 — CLARIFY (bounded pass)

Ask **only** the questions the codebase genuinely cannot answer — the preference and
scope forks. Cap at **3–5 questions**; batching is allowed (one `AskUserQuestion` call
with multiple questions where available).

Good questions to ask (when code can't answer them):
- **Scope boundary** — what's in v1 vs explicitly deferred.
- **Behavior forks** — real-time vs batch, sync vs async, the genuine "which way" decisions.
- **Data/contract shape** — only where the design hinges on it and code gives no signal.
- **Non-goals** — what this explicitly will NOT do.

Do NOT ask: anything a config, manifest, test file, or existing pattern already states.
When the code answers it, say so in the spec instead of asking.

If the user said "no questions, just draft it" — skip to WRITE and capture every guess
in an `## Open Questions` / assumptions section instead.

---

### Step 3 — WRITE

Write the spec to `<specDir>/YYYY-MM-DD-<topic>-design.md` (`<topic>` = short kebab-case
slug). `<specDir>` is `preferences.specDir` from config when present, else `docs/plans`.

Use the template, **section-scaling rules**, writing style, and Decision Log format
from **`absolute-work`'s `references/spec-writing.md`** — that file is the single source of truth;
do not restate it here, load it. In particular:

- Pick the complexity tier (**Simple / Medium / Complex**) using the complexity
  heuristic table, and scale sections accordingly. Remove sections that would only say
  "N/A".
- Be **concrete**: real file paths, real endpoints, real schemas in code blocks — never
  "an endpoint for X".
- Fill the **Decision Log** with the forks resolved in CLARIFY plus any you recommended,
  each with a one-line rationale.

---

### Step 4 — REVIEW (scored, independent)

Dispatch a **separate** reviewer subagent — the agent that wrote the spec does not grade
it (generator ≠ evaluator). Use the **rubric and reviewer prompt template verbatim** from
`absolute-work`'s `references/spec-writing.md` (*Scored Spec Review Protocol*): graded on
Completeness, Consistency, Clarity, Scope, Testability (1–5 each, weighted).

| Weighted Score | Verdict | Action |
|---|---|---|
| 4.0 – 5.0 | Approved | Proceed to HANDOFF |
| 3.0 – 3.9 | Needs Work | Fix the flagged issues, re-dispatch (max 3 iterations) |
| < 3.0 | Major Gaps | Surface to the user immediately; do not silently iterate |

Reviewer approval is necessary but not the end — the user still has the final say at
HANDOFF.

---

### Step 5 — HANDOFF

1. **Present** — the spec path, the complexity tier, and the reviewer's weighted score +
   verdict. Summarize the key decisions in 2–4 lines.
2. **Offer to build** — chain into **`/absolute work`**, which will pick up the spec at
   its decompose phase rather than re-running intake. Make this an explicit, optional
   next step.
3. **Stop.** No code, no board. **Never run `git commit`** — suggest a message if asked;
   the user commits.

---

## Gotchas

1. **Drifting into `work`.** If you start decomposing into tasks or writing code, you've
   left `spec`. Stop at the reviewed doc.
2. **Asking what the code answers.** The bounded pass is for preferences and forks only —
   scan first, ask second.
3. **Skipping the review to "stay light".** The review is the cheap quality gate that
   makes a standalone spec trustworthy. Keep it.
4. **Restating `spec-writing.md`.** Load it; don't copy the template/rubric in here —
   two copies drift.
5. **Over-asking.** More than ~5 questions means you're running `work`'s interview. Tighten.

---

## Output / Response Style

Respond terse like smart caveman. All technical substance stay. Only fluff die. Drop
articles, filler, pleasantries, hedging. Fragments OK. Technical terms exact. Code blocks
and quoted errors unchanged. Drop caveman for security warnings, irreversible-action
confirmations, and any multi-step sequence where fragment order risks misread; resume
after. Spec prose itself is written normally (it's a deliverable, not chat).

---

## Companion commands

Sibling commands in this skill chain naturally around `spec`:

- **`/absolute work`** — build what the spec describes (picks the spec up at decompose).
- **`/absolute ui`** — design the interface for a feature the spec defines.
- **`/absolute docs`** — once it's built and shipped, document it for readers.

Suggest them where relevant; they're always available (same skill, no extra install).

© dhruvjainin · MIT · dhruvjainin/absolute

Похожие скиллы

Все скиллы по теме «Дизайн» →
spec-workflow TencentCloudBase Скилл spec-workflow для Claude Code структурирует разработку средних и крупных задач через артефакты требований, дизайна и плана. Включается перед написанием кода при нечётких критериях приёмки. CX Codex +1 1 200установок cursor-spec-interviewer stark-ai-de Скилл cursor-spec-interviewer для Claude Code, Codex, Cursor и других агентных платформ превращает размытый запрос в согласованную спецификацию реализации с критериями приёмки. CX Codex +1 2 700установок om-spec-writing open-mercato Скилл om-spec-writing помогает писать и проверять спецификации фич: от каркаса и открытых вопросов до архитектурного разбора и плана реализации. CX Codex +1 3 900установок spec-writer dannwaneri Скилл spec-writer превращает туманное описание фичи в структурированный спек, технический план и список задач. Помечает каждое предположение прямо в тексте, чтобы вы могли исправить неточности до того, как агент начнёт кодить. CX Codex +1 ★ 29звёзд репо spec Klerith Проектирует спецификации по методологии spec-driven development. Задаёт уточняющие вопросы блоками и формирует файл требований в папке specs/ перед написанием кода. CX Codex +1 5 000установок spec-driven-development addyosmani Скилл spec-driven-development для Claude Code готовит спецификацию до начала разработки. Он включается, когда нужно разобрать расплывчатые требования, спланировать функцию или оформить изменения к уже выпущенной спецификации. CX Codex +1 81 900установок

Из того же набора11

Весь набор →
absolute-audit Скилл absolute-audit для Claude Code ищет уязвимости в зависимостях и рискованные участки кода. Запускается по запросам на аудит безопасности, поиск CVE или секретов и усиление защиты. CX Codex +1 592установок absolute-ui Скилл absolute-ui для Claude Code задаёт правила оформления интерфейсов через конкретные значения CSS и Tailwind. Активируется при запросах о компонентах, отступах, типографике, тёмной теме и адаптивной вёрстке. CX Codex +1 382установок absolute-simplify Скилл absolute-simplify для Claude Code и Cursor, который упрощает код, снижает вложенность и удаляет мёртвый код. Запускается автономно на изменённых файлах или выбранном пути. CX Codex +1 336установок absolute-work Скилл absolute-work для Claude Code и Codex ведёт разработку через фазовые переходы от интервью по архитектуре до проверенного тестами кода. Включается при запросах на полный цикл создания фичи или миграцию. CX Codex +1 216установок absolute-docs Скилл absolute-docs для Claude Code структурирует техническую документацию по методологии Diátaxis. Помогает писать руководства, справочники, README и проводить аудит существующих страниц. CX Codex +1 171установок absolute-prune Скилл absolute-prune для Claude Code очищает репозиторий от мёртвого кода и неиспользуемых зависимостей. Запускается на чистой ветке main по подтверждённым данным статических анализаторов. CX Codex +1 170установок absolute-deflake Скилл absolute-deflake для Claude Code находит тесты, которые то проходят, то падают, и исправляет источник нестабильности. Запускается по запросам о случайных сбоях тестов и проблемах с flaky CI. CX Codex +1 165установок absolute-debt Скилл absolute-debt для Claude Code устраняет накопленные ошибки линтеров и проверки типов по всему репозиторию. Очистка запускается волнами на зелёной ветке main. CX Codex +1 162установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой