Agent skill

Docs To Types

by modernweb-dev in modernweb-dev/rocket

Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture.

MITAuto-check passedDevelopment

Install Docs To Types

skills CLI
$ npx skills add modernweb-dev/rocket --skill docs-to-types -a claude-code

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

GitHub CLI
$ gh skill install modernweb-dev/rocket docs-to-types --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/modernweb-dev/rocket.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-to-types .claude/skills/docs-to-types && 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
docs-to-types
GitHub stars
395
Token cost
~1.1k tokens
SKILL.md length
452 words
Files
2
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture.

  • Works in 5 steps: Extract architecture facts → Ambiguity gate → Propose the typed structure → …
  • Wants domain types
  • SKILL.md covers Prime directive, Read first and Workflow
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Docs To Types is an agent skill from modernweb-dev/rocket. Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture. Use after grill-with-docs when the user wants domain types, seams, adapters, errors, call stacks, and dependency rules expressed in code before business behavior.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `REFERENCE.md`).

It sits in Development, covering Architecture decision records and Static sites and blogs. The repository describes itself as: The modern web setup for static sites with a sprinkle of JavaScript. The licence is MIT.

When your agent uses it

  • Wants domain types
  • Dependency rules expressed in code before business behavior

Example prompts

  • “Use the docs-to-types skill to convert grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture”
  • “/docs-to-types”

Workflow steps

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

  1. Extract architecture facts
  2. Ambiguity gate
  3. Propose the typed structure
  4. Codify only the typed structure
  5. Validate and report

What it can do on your machine

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

    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

Docs To Types loads about 1.1k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 452 words of instructions outside code blocks.

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

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

The full file from modernweb-dev/rocket at commit c4a9515, republished under its MIT licence (© modernweb-dev). 452 words, ~1,056 tokens.

Download SKILL.mdSave it as .claude/skills/docs-to-types/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
docs-to-types
description
Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture. Use after grill-with-docs when the user wants domain types, seams, adapters, errors, call stacks, and dependency rules expressed in code before business behavior.

Docs to Types

Upfront architecture skill for converting clarified prose into typed architecture. If the team knows a durable domain or architecture fact, the type system and module graph should know it too.

Not for general grilling, refactoring review, or the first TDD slice. CONTEXT.md, ADRs, and grill notes are source material, not the final harness.

Prime directive

Do not implement business behavior. Compress approved context into the whole intended typed architecture:

  • canonical domain types, schemas, brands, and invariants
  • discriminated unions/state models that rule out invalid states
  • smart constructors/parsers for values entering from system edges
  • service/interface seams using project conventions
  • typed result/error families and error translation boundaries
  • production/test adapter slots
  • composition/layer/module topology using project conventions
  • production and test call stacks
  • dependency-direction checks where practical

Do not create business workflows, real persistence/network logic, product behavior, after-the-fact refactors, generic mutation/outcome frameworks, or fake production logic pretending to be complete.

Read first

  1. AGENTS.md and project coding rules
  2. CONTEXT-MAP.md, if present
  3. relevant CONTEXT.md files
  4. relevant docs/adr/*
  5. approved grill-with-docs notes/specs
  6. existing source near the target area

If there are no context docs/ADRs and no approved grill-with-docs output, stop and recommend grill-with-docs.

Workflow

1. Extract architecture facts

Before editing, produce a fact table:

md
| Fact                                        | Source     | Code artifact         | Confidence |
| ------------------------------------------- | ---------- | --------------------- | ---------- |
| Link Catalog is the application-facing seam | CONTEXT.md | `LinkCatalog` service | high       |

Include domain names, ownership boundaries, dependency direction, call stacks, adapter choices, runtime constraints, typed errors, and infrastructure that must stay behind adapters.

2. Ambiguity gate

If docs, code, or user plan conflict, ask one concrete question and wait.

If a prose fact cannot be represented cleanly as a type, seam, adapter, state, error, or dependency rule, treat the domain language as still ambiguous.

Example: CONTEXT.md says “Operator,” but code says “User” and “Actor.” Which is canonical?

Show full SKILL.md (173 more words)Show less
3. Propose the typed structure

Before editing, unless the user requested direct implementation, list:

  • files to create/update
  • domain types/schemas/brands/invariants/smart constructors
  • state models/discriminated unions
  • service/interface seams
  • typed result/error families
  • production and test call stacks
  • adapter slots/stubs
  • architecture checks
  • business logic intentionally excluded

Ask for approval.

4. Codify only the typed structure

When approved, write compiling architecture code for the full intended typed structure.

Rules:

  • Use project domain names exactly.
  • Prefer deep modules: small interfaces, complexity behind the seam.
  • Follow project conventions for services, interfaces, DI, composition, layers, factories, providers, or registries.
  • Model absence, validation, variants, states, and expected failures with project-native typed patterns.
  • Keep HTTP/UI/CLI transport details at their boundaries.
  • Keep storage, SQL, queues, RPC clients, SDKs, and third-party APIs behind adapters.
  • Add architecture tests/lint/import rules when dependency direction can be checked mechanically.

See REFERENCE.md for allowed code depth and examples.

5. Validate and report

Run narrow checks: typecheck, lint/static checks, and architecture tests if added. Final response: facts codified, files changed, production/test call stacks, adapter slots, checks run, and business logic left unimplemented.

© modernweb-dev, 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 1 other file in .agents/skills/docs-to-types of modernweb-dev/rocket.

  • SKILL.md
  • REFERENCE.md

Open the folder on GitHubat commit c4a9515

Compare with similar skills

Docs To Types 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.

Docs To Types compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs To Types this skillmodernweb-dev/rocket395—~1.1kAutomated safety check: PassMIT
Generating Documentationancoleman/ai-design-components526—~3kAutomated safety check: PassMIT
Maintainer Docs Site Authoringdevcodex-labs/devcodex439—~489Automated safety check: PassAGPL-3.0
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Astro Developerwithastro/astro63k1 repos~1.5kAutomated safety check: PassCustom licence
Astro PR Writerwithastro/astro63k—~1.2kAutomated safety check: PassCustom licence

Similar skills

  • Generating Documentation

    ancoleman/ai-design-components

    Generate comprehensive technical documentation including API docs (OpenAPI/Swagger), code documentation (TypeDoc/Sphinx), documentation sites (Docusaurus/MkDocs), Architecture Decision Records…

    526 GitHub stars~3k tokensUpdated 10 mo ago
    DevelopmentAuto-check passed
  • Maintainer Docs Site Authoring

    devcodex-labs/devcodex

    维护者/贡献者开发站点文档写作 Owner — 本地开发、贡献、测试、发版 runbook、internals/ADR;与用户使用站不等价;写文档时经 DocsAudienceIntent 路由。

    439 GitHub stars~489 tokensUpdated 20 days ago
    DevOps & CloudAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Astro Developer

    withastro/astro

    Official

    Comprehensive guide for developing in the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • Astro PR Writer

    withastro/astro

    Official

    Write and update Astro pull requests with reviewer-friendly titles and high-signal bodies.

    63k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    380 GitHub starsUsed in 4 repos~2.4k tokens
    DevelopmentAuto-check passed

More from modernweb-dev/rocket

  • Rocket

    modernweb-dev/rocket

    A skill your agent uses when editing Rocket Pages, config, layouts, component reference Pages, or build behavior in this project.

    395 GitHub stars~536 tokensUpdated 9 days ago
    Auto-check passed
  • Coding Style

    modernweb-dev/rocket

    Indexes this repo's coding conventions for file placement, tests, API shape, component authoring, and commit messages.

    395 GitHub stars~210 tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Docs To Types

What does Docs To Types do?

Converts grill-with-docs output — CONTEXT.md glossaries, ADRs, and approved domain decisions — into typed architecture. Docs To Types is an agent skill from modernweb-dev/rocket.md glossaries, ADRs, and approved domain decisions — into typed architecture.

When should I use Docs To Types?

Docs To Types fits situations like: wants domain types; dependency rules expressed in code before business behavior.

How do I install Docs To Types in Claude Code?

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

How do I install Docs To Types in Codex?

Run `npx skills add modernweb-dev/rocket --skill docs-to-types -a codex`. Or copy the skill folder (.agents/skills/docs-to-types in modernweb-dev/rocket) into .agents/skills/docs-to-types in your project. Codex loads it when a task matches its description.

Can I use Docs To Types 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 modernweb-dev/rocket --skill docs-to-types -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-to-types, .gemini/skills/docs-to-types, .github/skills/docs-to-types and .opencode/skills/docs-to-types in your project.

What does Docs To Types need to run?

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

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

Docs To Types 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 Docs To Types use?

About 1.1k tokens (SKILL.md is roughly 4.2k 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 Docs To Types?

Skills that share tags, products or a category with Docs To Types: Generating Documentation (ancoleman/ai-design-components, 526 stars), Maintainer Docs Site Authoring (devcodex-labs/devcodex, 439 stars), PR Design Doc (OpenHands/OpenHands, 90k stars) and Astro Developer (withastro/astro, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs To Types?

modernweb-dev (a GitHub organization) maintains it in modernweb-dev/rocket, which has 395 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 28, 2026.

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