Agent skill

Site Specification

by Automattic in Automattic/wordpress-agent-skills

Extract comprehensive site specifications from simple descriptions.

No licenceAuto-check passedFrontend & Design

Install Site Specification

skills CLI
$ npx skills add Automattic/wordpress-agent-skills --skill site-specification -a claude-code

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

GitHub CLI
$ gh skill install Automattic/wordpress-agent-skills site-specification --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/Automattic/wordpress-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude-code/wp-site-creator/skills/site-specification .claude/skills/site-specification && 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
site-specification
GitHub stars
115
Token cost
~2.7k tokens
SKILL.md length
698 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Extract comprehensive site specifications from simple descriptions.

  • Analyzing a users theme request to determine site type
  • SKILL.md covers Site Spec Schema, Inference Patterns by Site Type, Examples and Presentation Format
  • Reaches fonts.googleapis.com
  • Layout requirements

What it does

Site Specification is an agent skill from Automattic/wordpress-agent-skills. Extract comprehensive site specifications from simple descriptions. Use when analyzing a user's theme request to determine site type, audience, tone, layout requirements, and typography.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Typography. The repository describes itself as: A collection of agent skills that can be used to create WordPress themes and sites.

When your agent uses it

  • Analyzing a users theme request to determine site type
  • Layout requirements

Example prompts

  • “/site-specification”

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • fonts.googleapis.com

    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

Site Specification loads about 2.7k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 698 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 698 words (~2,745 tokens).

“Extract detailed site specifications from user descriptions to guide theme generation. If the user has provided images, image urls or other documents, analyze them for additional clues about the brand and design preferences - obviously things like an exising logo…”

— opening of SKILL.md by Automattic
name
site-specification

Read the full SKILL.md on GitHub

Files

Just SKILL.md in claude-code/wp-site-creator/skills/site-specification of Automattic/wordpress-agent-skills.

Open the folder on GitHubat commit ea902bd

Compare with similar skills

Site Specification 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.

Site Specification compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Site Specification this skillAutomattic/wordpress-agent-skills115—~2.7kAutomated safety check: PassNone
Editorial DocumentSidiora-Labs/centra-gideon-agent217—~1.3kAutomated safety check: PassApache-2.0
Design Archivistcuriositech/some_claude_skills243—~1.6kAutomated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Tailwindcss Developmentanonaddy/anonaddy4.9k10 repos~865Automated safety check: PassMIT
Design SystemOhh-889/skyroc79511 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Editorial Document

    Sidiora-Labs/centra-gideon-agent

    Write long-form editorial documents as clean, semantic HTML saved as an artifact (kind=document) — reports, briefs, explainers, proposals, write-ups.

    217 GitHub stars~1.3k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Design Archivist

    curiositech/some_claude_skills

    Long-running design anthropologist that builds comprehensive visual databases from 500-1000 real-world examples, extracting color palettes, typography patterns, layout systems, and interaction…

    243 GitHub stars~1.6k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed
  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed
  • Make Interfaces Feel Better

    samuelclay/NewsBlur

    Design engineering principles for making interfaces feel polished.

    7.6k GitHub starsUsed in 10 repos~1.5k tokens
    Frontend & DesignAuto-check passed

More from Automattic/wordpress-agent-skills

  • Design Systems

    Automattic/wordpress-agent-skills

    Bold aesthetic direction guidance for web design. An agent skill from Automattic/wordpress-agent-skills.

    115 GitHub stars~2.5k tokensUpdated 6 mo ago
    Auto-check passed
  • Wordpress Block Theming

    Automattic/wordpress-agent-skills

    WordPress Full Site Editing (FSE) theme architecture. An agent skill from Automattic/wordpress-agent-skills.

    115 GitHub stars~4.8k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Site Specification

What does Site Specification do?

Extract comprehensive site specifications from simple descriptions. Site Specification is an agent skill from Automattic/wordpress-agent-skills. Extract comprehensive site specifications from simple descriptions.

When should I use Site Specification?

Site Specification fits situations like: analyzing a users theme request to determine site type; layout requirements.

How do I install Site Specification in Claude Code?

Run `npx skills add Automattic/wordpress-agent-skills --skill site-specification -a claude-code`. Or copy the skill folder (claude-code/wp-site-creator/skills/site-specification in Automattic/wordpress-agent-skills) into .claude/skills/site-specification in your project. Claude Code loads it when a task matches its description.

How do I install Site Specification in Codex?

Run `npx skills add Automattic/wordpress-agent-skills --skill site-specification -a codex`. Or copy the skill folder (claude-code/wp-site-creator/skills/site-specification in Automattic/wordpress-agent-skills) into .agents/skills/site-specification in your project. Codex loads it when a task matches its description.

Can I use Site Specification 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 Automattic/wordpress-agent-skills --skill site-specification -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/site-specification, .gemini/skills/site-specification, .github/skills/site-specification and .opencode/skills/site-specification in your project.

What does Site Specification need to run?

SKILL.md names no scripts, command-line tools or credentials: Site Specification is instructions for the agent only.

Does Site Specification access the network?

SKILL.md names 1 domain. In commands or code: fonts.googleapis.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Site Specification safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Site Specification use?

No licence was found for Site Specification or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Site Specification use?

About 2.7k tokens (SKILL.md is roughly 11k 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 Site Specification?

Skills that share tags, products or a category with Site Specification: Editorial Document (Sidiora-Labs/centra-gideon-agent, 217 stars), Design Archivist (curiositech/some_claude_skills, 243 stars), Impeccable (bestofjs/bestofjs, 3.1k stars) and Tailwindcss Development (anonaddy/anonaddy, 4.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Site Specification?

Automattic (a GitHub organization) maintains it in Automattic/wordpress-agent-skills, which has 115 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on March 17, 2026.

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