spec-first SKILL.md skillA

spec-first from gurudevvv/my-claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gurudevvv/my-claude-skills/spec-first@git:20261002.99396ab

Pins git:20261002.99396ab in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gurudevvv/my-claude-skills
Path
mine/spec-first/SKILL.md
Versions recorded
3
Latest version
git:20261002.99396ab, committed Oct 2, 2026
First version recorded
Jul 27, 2026
Size
18,726 bytes
Repository stars
5
License
MIT

Start a new project with a spec before code. Two phases: Vision (what/why) then Blueprint (how/order). Use when: user describes a new project idea ("I want to build a bot", "need a site for...", "new project", "start a project", "plan the project", "build me", "let's make"), says /spec-first, or when existing code has no docs/vision/blueprint. Also triggers on Russian: "хочу сделать", "нужен сайт для", "новый проект", "начинаем", "давай спеку", "запускаем". Do NOT use for: reviewing existing…

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

# Spec-First — старт проекта через спецификацию

Структурированный запуск проекта: сначала спека, потом код. Две фазы: Vision (что и зачем) → Blueprint (как и в каком порядке).

## Онбординг

Скажи пользователю:

"Давай сначала опишем проект — я задам несколько простых вопросов, а потом сам составлю план сборки. Это займёт около 20 минут.

Без плана я могу начать делать не то, выбрать неподходящие технологии или забыть важное на полпути. С планом — собираем с первого раза, и если продолжим в новой сессии — контекст не потеряется."

---

## Определи фазу

Все пути (`docs/vision.md`, `docs/blueprint.md`) — относительно корня проекта (текущая рабочая директория). Если папка `docs/` не существует — создай.

### Проверь контекст

| Код есть? | vision.md | blueprint.md | Действие |
|-----------|-----------|--------------|----------|
| Нет | Нет | Нет | **Vision** с нуля |
| Нет | Да | Нет | Проверь что vision.md содержит секции "User Stories" и "MVP Scope". Если да → **Blueprint**. Если нет → дополни Vision |
| Нет | Да | Да | Покажи статус (задачи из blueprint), предложи начать сборку |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gurudevvv/my-claude-skills/spec-first@sha256:be46d3885cdb6ae2

The line at the top of this page pins the label git:20261002.99396ab, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_zaajyvxzhs6eczhl.svg)](https://markdownregistry.com/a/art_zaajyvxzhs6eczhl)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jul 27, 2026 and Oct 2, 2026, about one every 33 days.

versioncommittedcommitsizeaudit
git:20261002.99396ab latest2026-10-02 99396ab 18,726 BA view · diff
git:20261002.a76280b2026-10-02 a76280b 18,260 BA view · diff
git:20260727.a9e95242026-07-27 a9e9524 18,298 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18726 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

GitHub

gurudevvv/my-claude-skills · 5 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zaajyvxzhs6eczhl
GET https://markdownregistry.com/api/v1/resolve?ref=gurudevvv/my-claude-skills/spec-first
GET https://markdownregistry.com/api/v1/blob/be46d3885cdb6ae284b42adba4124537e654465451dc46e2432667e8973587bd

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.

More from gurudevvv/my-claude-skills

CLAUDE.md CLAUDE.md file
gurudevvv/my-claude-skills · CLAUDE.md
git:20261021.7501e1d · audit A · 5 stars
doc-to-markdown SKILL.md skill
gurudevvv/my-claude-skills · external/doc-to-markdown/SKILL.md · Converts DOCX/PDF/PPTX to high-quality Markdown with automatic post-processing. Fixes pandoc grid tables, simple…
git:20260806.ec6b957 · audit A · 5 stars
high-output-management SKILL.md skill
gurudevvv/my-claude-skills · external/high-output-management/SKILL.md · Manage for output using Grove''s "High Output Management": a manager''s output is their organization''s output, raised…
v1.2.0 · audit A · 5 stars
marketing-plan SKILL.md skill
gurudevvv/my-claude-skills · external/marketing-plan/SKILL.md · When the user needs a comprehensive marketing plan for a client, a company they advise, or their own product. Also use…
git:20260727.59851fd · audit A · 5 stars
meeting-minutes-taker SKILL.md skill
gurudevvv/my-claude-skills · external/meeting-minutes-taker/SKILL.md · Transforms raw meeting transcripts into high-fidelity, structured meeting minutes (notes / summaries). Use when (1) a…
git:20260727.59851fd · audit A · 5 stars
mermaid-tools SKILL.md skill
gurudevvv/my-claude-skills · external/mermaid-tools/SKILL.md · Extracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts. Activates…
git:20260727.59851fd · audit A · 5 stars
negotiation SKILL.md skill
gurudevvv/my-claude-skills · external/negotiation/SKILL.md · Prepare and execute negotiations using tactical empathy, calibrated questions, and the Ackerman method. Use when the…
v1.5.0 · audit A · 5 stars
ppt-creator SKILL.md skill
gurudevvv/my-claude-skills · external/ppt-creator/SKILL.md · Create professional slide decks from topics or documents. Generates structured content with data-driven charts, speaker…
git:20260727.59851fd · audit A · 5 stars
pricing SKILL.md skill
gurudevvv/my-claude-skills · external/pricing/SKILL.md · When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions…
v2.0.1 · audit A · 5 stars
site-architecture SKILL.md skill
gurudevvv/my-claude-skills · external/site-architecture/SKILL.md · When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal…
v2.0.0 · audit A · 5 stars
skill-conductor SKILL.md skill
gurudevvv/my-claude-skills · external/skill-conductor/SKILL.md · Create, edit, evaluate, and package agent skills. Use when building a new skill from scratch, improving an existing…
git:20260727.59851fd · audit A · 5 stars
ui-ux-pro-max SKILL.md skill
gurudevvv/my-claude-skills · external/ui-ux-pro-max/SKILL.md · UI/UX design intelligence. 67 styles, 96 palettes, 57 font pairings, 25 charts, 13 stacks (React, Next.js, Vue, Svelte…
git:20260727.59851fd · audit A · 5 stars

Every file in gurudevvv/my-claude-skills

Browse by kind, by grade A, or by owner.