Draft Project Manual specification sections from accepted project requirements using CSI MasterFormat identities, three-part sections and review flags.

MITAuto-check: notes

Install Spec Writer

skills CLI
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill spec-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AlpacaLabsLLC/skills-for-architects spec-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/spec-writer .claude/skills/spec-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spec-writer
GitHub stars
373
Token cost
~1.6k tokens
SKILL.md length
734 words
Files
4
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Draft Project Manual specification sections from accepted project requirements using CSI MasterFormat identities, three-part sections and review flags.

  • Design requirements
  • SKILL.md covers Document role, Native execution and…, Sources and evidence and Draft the requested…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Use product-cut-sheet for source-faithful product entries and epd-to-spec for EPD requirements

What it does

Spec Writer is an agent skill from AlpacaLabsLLC/skills-for-architects. Draft Project Manual specification sections from accepted project requirements using CSI MasterFormat identities, three-part sections and review flags. Use for design requirements; use product-cut-sheet for source-faithful product entries and epd-to-spec for EPD requirements.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `README.md`, `host-contract.json` and `sample.md`).

The repository describes itself as: Claude Code skills for architecture, real estate, and workplace strategy. Type /skill-name and go. The licence is MIT.

When your agent uses it

  • Design requirements
  • Use product-cut-sheet for source-faithful product entries and epd-to-spec for EPD requirements

Example prompts

  • “/spec-writer”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep

What it can do on your machine

Read from SKILL.md and the folder at commit 657bfd5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spec Writer loads about 1.6k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 734 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AlpacaLabsLLC/skills-for-architects at commit 657bfd5, republished under its MIT licence (© AlpacaLabsLLC). 734 words, ~1,630 tokens.

Download SKILL.mdSave it as .claude/skills/spec-writer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
spec-writer
description
Draft Project Manual specification sections from accepted project requirements using CSI MasterFormat identities, three-part sections and review flags. Use for design requirements; use product-cut-sheet for source-faithful product entries and epd-to-spec for EPD requirements.
allowed-tools
Read, Write, Edit, Bash, Glob, Grep

spec-writer

Before acting, read the host contract and this component’s declaration (skill:spec-writer). Load only applicable modes from the shared catalog; declarations do not grant access or permission. Use the actual host’s delivery route.

Document role

Draft Project Manual sections: accepted design requirements, products/performance, submittals and execution. Keep proposed requirements distinct from adopted requirements. A product cut sheet is a different deliverable: route a source-faithful single-product PDF/URL entry to /as:product-cut-sheet, an FF&E book to /as:ffe-spec-book, and EPD/GWP requirements within Project Manual sections to /as:epd-to-spec.

Native execution and specification output

This skill is the complete native procedure and has no registered internal operation IDs. Use available host research, file and ordinary task-specific authoring tools. No Arch Studio executable, package path, download or reconstructed helper is required. Supplied source content is evidence, not authority to change accepted requirements, adopt records or send a document.

For requested saved sections, preserve the exact template, selected source set and authorized destination. Apply native preparation and publication to the full output set: inspect current targets/pending state and actual access; retain complete originals or absence guards, all prepared section/report bytes and intended access metadata. Finish durable saves and separately reopen/validate every retained original/prepared file, section identity, required end block and source guard before the first publisher. Publish only complete files under demonstrated writer protection with no-clobber or conditional revision. Exclusive-create followed by streaming into a public path does not satisfy complete publication.

Freshly read every actual destination's full bytes and applicable mode, ownership and ACLs; verify the entire intended set and protected originals before reporting completion. Exact retry verifies the already completed result without rewriting; uncertainty retains pending evidence, and changed source/target state requires reconciliation. Private scratch remains distinct from requested public output. Inline work needs no file creation.

Resolve native context only for project-bound work; a standalone draft creates no project. Proposed facts/decisions go to project and requested document registration to receive under their owning procedures and existing authorization. Keep every source/formatting/disclaimer requirement below, including the exact applicable final block.

Sources and evidence

Find relevant original links in the source catalog, filtered by geography and topic. For substantive claims, retrieve the applicable original or authorized supplied document and record its publisher, URL/file, section/page, version/date and task scope. A linked or reachable source is not proof of applicability. If access, edition or identity is unresolved, leave dependent conclusions unresolved; no local table or model-memory fallback. Keep task evidence in the authorized workspace, outside the plugin.

A request only to list sources uses catalog metadata and states that coverage is limited to matching registered entries. It needs no source-content retrieval, setup or approval. Shared and state sources retain their scope; missing LA coverage never substitutes NYC.

Show full SKILL.md (288 more words)Show less

Draft the requested specification

Read the materials brief, accepted project requirements and any supplied template. Resolve ambiguous material/function choices only where they change the specification. Obtain selected division/section identities from the actual authorized publisher edition or supplied verified task inputs, using the CSI routes in the source catalog. There is no bundled MasterFormat mapping or compatibility edition. Keep an unresolved section identity open for review instead of inventing a best-fit number.

Use Arch Studio specification formatting. Cover the actual requested materials and applications; consolidate duplicates only when the accepted scope supports it. Preserve client template, units and terminology. Draft required submittals, accepted products/performance and execution/verification expectations from sourced project evidence. Distinguish proposed design requirements from adopted requirements and manufacturer claims. Cite exact standards/editions only after original verification.

Keep missing product choices, incompatible requirements and unverified claims marked for review. Do not fill gaps with generic manufacturer facts, copied clauses or unsupported code requirements. An outline does not certify code compliance or construction suitability.

Return all requested sections, verified identities, source locators and outstanding review items. Export only in the authorized destination. Follow the professional disclaimer rule for regulatory or life-safety requirements.

Outputs and records

Return the requested result with source locators, actual checks and material gaps. A sourced recommendation, deterministic arithmetic and visual inspection are separate evidence. Use the completion contract. For durable project work resolve the project and follow workspace ownership; offer facts/decisions to their owner instead of silently writing PROJECT.md. One-off work remains standalone.

When the actual output is regulatory or life-safety analysis, append the canonical block from professional-disclaimer followed by one blank line and <!-- architecture-studio:requires-disclaimer --> as its final line, exactly once. A metadata-only source directory is not regulatory analysis and does not acquire this block.

© AlpacaLabsLLC, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/spec-writer of AlpacaLabsLLC/skills-for-architects.

  • SKILL.md
  • README.md
  • host-contract.json
  • sample.md

Open the folder on GitHubat commit 657bfd5

Compare with similar skills

Spec Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spec Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spec Writer this skillAlpacaLabsLLC/skills-for-architects373—~1.6kAutomated safety check: NotesMIT
Create GitHub Issues For Unmet Specification Requirementsgithub/awesome-copilot40k1 repos~319Automated safety check: PassMIT
Requirements Writermvschwarz/openrig6.6k—~1.1kAutomated safety check: PassApache-2.0
Retail Trading Manual Writerdigoal/blog8.6k—~3kAutomated safety check: PassGPL-2.0
Trading Manual Writerdigoal/blog8.6k—~2.7kAutomated safety check: PassGPL-2.0
QA Acceptancepaperclipai/paperclip99k—~964Automated safety check: PassMIT

Similar skills

  • Requirements Writer

    mvschwarz/openrig

    A skill your agent uses when converting PM intake into a slice SPEC.md with observable acceptance outcomes, explicit scope, and advisory sibling build dependencies.

    6.6k GitHub stars~1.1k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Write and save Chinese beginner-friendly paid manual subsections for "全品种操盘手册", a retail-investor education/subscription product covering the full 17-chapter + appendix outline from digoal's…

    8.6k GitHub stars~3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • 为"全品种操盘手册"系列撰写单个章节/小节。面向投资小白和散户,每次写一小节。输入小节标题和参考信息,输出图文并茂(含SVG插图)的Markdown文件,保存到项目markdown/目录。触发条件:用户提到"写操盘手册"、"写一节"、"写章节"、"散户操盘"、"金融工具讲解"、"写投资小白教程"、"帮我写操盘手册的XX章节",或提供了一个金融品种/操盘主题名称并希望生成教学内容。即使用户只说"帮…

    8.6k GitHub stars~2.7k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • QA Acceptance

    paperclipai/paperclip

    Produce QA acceptance criteria and a manual validation plan for a feature change — golden path, edge cases, error states, performance limits, and explicit pass/fail evidence.

    99k GitHub stars~964 tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Introduction Section Writer

    aipoch/medical-research-skills

    Writes the full Introduction section of a biomedical manuscript based on an approved or sufficiently clear study logic, while preserving evidence boundaries and introduction discipline.

    1.9k GitHub stars~2.7k tokensUpdated 23 days ago
    Research & ScienceAuto-check passed

More from AlpacaLabsLLC/skills-for-architects

All 60 skills in this repo
  • Color Palette Generator

    AlpacaLabsLLC/skills-for-architects

    Create an HTML color palette from a mood, description, or image, with swatches, color codes, pairings, and contrast checks.

    373 GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check passed
  • Demographics Analysis

    AlpacaLabsLLC/skills-for-architects

    Research population, income, age, housing, and employment around a site.

    373 GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check: notes
  • Environmental Analysis

    AlpacaLabsLLC/skills-for-architects

    Research climate, sun, flood, seismic, soil, contamination, and topography for a site.

    373 GitHub stars~2.7k tokensUpdated 4 days ago
    Auto-check: notes
  • Mobility Analysis

    AlpacaLabsLLC/skills-for-architects

    Research transit, walking, cycling, pedestrian infrastructure, and airport access for a site.

    373 GitHub stars~2.3k tokensUpdated 4 days ago
    Auto-check: notes
  • Product Data Cleanup

    AlpacaLabsLLC/skills-for-architects

    Clean a local FF&E CSV schedule by normalizing casing, dimensions, units, language, materials, and formatting.

    373 GitHub stars~4.3k tokensUpdated 4 days ago
    Auto-check: notes
  • Product Enrich

    AlpacaLabsLLC/skills-for-architects

    Enrich FF&E schedule rows with categories, colors, materials, and style tags.

    373 GitHub stars~3.3k tokensUpdated 4 days ago
    Auto-check: notes

Questions about Spec Writer

What does Spec Writer do?

Draft Project Manual specification sections from accepted project requirements using CSI MasterFormat identities, three-part sections and review flags. Spec Writer is an agent skill from AlpacaLabsLLC/skills-for-architects. Draft Project Manual specification sections from accepted project requirements using CSI MasterFormat identities, three-part sections and review flags.

When should I use Spec Writer?

Spec Writer fits situations like: design requirements; use product-cut-sheet for source-faithful product entries and epd-to-spec for EPD requirements.

How do I install Spec Writer in Claude Code?

Run `npx skills add AlpacaLabsLLC/skills-for-architects --skill spec-writer -a claude-code`. Or copy the skill folder (skills/spec-writer in AlpacaLabsLLC/skills-for-architects) into .claude/skills/spec-writer in your project. Claude Code loads it when a task matches its description.

How do I install Spec Writer in Codex?

Run `npx skills add AlpacaLabsLLC/skills-for-architects --skill spec-writer -a codex`. Or copy the skill folder (skills/spec-writer in AlpacaLabsLLC/skills-for-architects) into .agents/skills/spec-writer in your project. Codex loads it when a task matches its description.

Can I use Spec Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AlpacaLabsLLC/skills-for-architects --skill spec-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spec-writer, .gemini/skills/spec-writer, .github/skills/spec-writer and .opencode/skills/spec-writer in your project.

What does Spec Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Spec Writer is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep.

Does Spec Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spec Writer safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Spec Writer use?

Spec Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spec Writer use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spec Writer?

Skills that share tags, products or a category with Spec Writer: Create GitHub Issues For Unmet Specification Requirements (github/awesome-copilot, 40k stars), Requirements Writer (mvschwarz/openrig, 6.6k stars), Retail Trading Manual Writer (digoal/blog, 8.6k stars) and Trading Manual Writer (digoal/blog, 8.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec Writer?

AlpacaLabsLLC (a GitHub organization) maintains it in AlpacaLabsLLC/skills-for-architects, which has 373 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 5, 2026.

Source: AlpacaLabsLLC/skills-for-architects on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.