Agent skill

To Spec

by blockscout in blockscout/frontend

Turn the current conversation into a product-task spec and publish it as a draft PR: no interview, just synthesis of what you've already discussed.

Custom licenceAuto-check passed

Install To Spec

skills CLI
$ npx skills add blockscout/frontend --skill to-spec -a claude-code

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

GitHub CLI
$ gh skill install blockscout/frontend to-spec --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/blockscout/frontend.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/to-spec .claude/skills/to-spec && 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
to-spec
GitHub stars
307
Token cost
~532 tokens
SKILL.md length
262 words
Files
3
Skills in repo
23
Repo updated
First seen
Licence
Custom licence

At a glance

Turn the current conversation into a product-task spec and publish it as a draft PR: no interview, just synthesis of what you've already discussed.

  • Works in 2 steps: Write the spec and questions → Branch and draft PR
  • SKILL.md covers Step 1 — Write the spec and… and Step 2 — Branch and draft PR
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

To Spec is an agent skill from blockscout/frontend. Turn the current conversation into a product-task spec and publish it as a draft PR: no interview, just synthesis of what you've already discussed.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `questions-template.md` and `spec-template.md`).

The repository describes itself as: Front-end application for Blockscout chain explorer.

Example prompts

  • “/to-spec”

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Write the spec and questions
  2. Branch and draft PR

What it can do on your machine

Read from SKILL.md and the folder at commit 9438622. 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.

    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

To Spec loads about 532 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 262 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 262 words (~532 tokens).

“Turn the finished conversation into a task's spec.md and questions.md. Synthesize what the conversation already settled; do not interview — the decisions and the open questions were made in the session that hands off here. This skill's whole job is…”

— opening of SKILL.md by blockscout, Custom licence
name
to-spec
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in .agents/skills/to-spec of blockscout/frontend.

  • SKILL.md
  • questions-template.md
  • spec-template.md

Open the folder on GitHubat commit 9438622

Compare with similar skills

To Spec 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.

To Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
To Spec this skillblockscout/frontend307—~532Automated safety check: PassCustom licence
Publishcode-yeongyu/oh-my-openagent70k—~5.5kAutomated safety check: WarnCustom licence
Social Publisheraffaan-m/ECC275k1 repos~1.1kAutomated safety check: PassMIT
Publishyc-software/qm15k—~2.2kAutomated safety check: WarnMIT
Social Publishingwshobson/agents40k—~914Automated safety check: PassMIT
Modeling Conversion MetricsPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Publish

    code-yeongyu/oh-my-openagent

    Publish oh-my-opencode to npm by triggering the GitHub Actions publish workflow and verifying its artifacts.

    70k GitHub stars~5.5k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Social Publisher

    affaan-m/ECC

    Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw.

    275k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Publish

    yc-software/qm

    Publish a long-lived internal web app, site, or dashboard from the agent computer.

    15k GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Social Publishing

    wshobson/agents

    Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API.

    40k GitHub stars~914 tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Official

    Build reusable conversion models — funnel/step conversion rates, drop-off, and time-to-convert — on either PostHog data-warehouse views (HogQL) or an external dbt project.

    40k GitHub stars~1.4k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Publish

    Q00/ouroboros

    Publish Seed specification as GitHub Issues for team-based project management

    6.2k GitHub stars~2.7k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from blockscout/frontend

All 23 skills in this repo
  • Slack File

    blockscout/frontend

    Download Slack attachments by file ID, or upload local files into a Slack thread.

    307 GitHub stars~540 tokensUpdated yesterday
    Auto-check passed
  • Add Env Var

    blockscout/frontend

    Step-by-step checklist for adding a new NEXTPUBLIC environment variable.

    307 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes
  • Add New Page

    blockscout/frontend

    Scaffold a new page (index / detail / general) and optionally wire it to API data.

    307 GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed
  • Create Issue

    blockscout/frontend

    Create a GitHub issue from the available context. An agent skill from blockscout/frontend.

    307 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Deprecate Env Var

    blockscout/frontend

    Checklist for deprecating a NEXTPUBLIC environment variable — immediate removal, or a grace period before a later removal.

    307 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check: notes
  • Publish Beta Types

    blockscout/frontend

    Publish a beta version of a @blockscout/-types npm package and pin it here.

    307 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about To Spec

What does To Spec do?

Turn the current conversation into a product-task spec and publish it as a draft PR: no interview, just synthesis of what you've already discussed. To Spec is an agent skill from blockscout/frontend. Turn the current conversation into a product-task spec and publish it as a draft PR: no interview, just synthesis of what you've already discussed.

How do I install To Spec in Claude Code?

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

How do I install To Spec in Codex?

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

Can I use To Spec 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 blockscout/frontend --skill to-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/to-spec, .gemini/skills/to-spec, .github/skills/to-spec and .opencode/skills/to-spec in your project.

What does To Spec need to run?

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

Does To Spec 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 To Spec 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 To Spec use?

To Spec has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does To Spec use?

About 532 tokens (SKILL.md is roughly 2.1k 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 To Spec?

Skills that share tags, products or a category with To Spec: Publish (code-yeongyu/oh-my-openagent, 70k stars), Social Publisher (affaan-m/ECC, 275k stars), Publish (yc-software/qm, 15k stars) and Social Publishing (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains To Spec?

blockscout (a GitHub organization) maintains it in blockscout/frontend, which has 307 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 7, 2026.

Source: blockscout/frontend on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.