Dsds Add

What it does

When your agent uses it

• Spec from component
• Spec from Figma

Example prompts

• “add spec”
• “create spec”
• “new spec”
• “/dsds-add”

Requirements

• Node.js

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Determine entry kind: component, token, theme, or the generic entry kind (for a foundation, pattern, guide, or anything else — use a…
2. 2Gather inputs — read the source (component source code, Figma frame, requirements doc).
3. 3Create {directory}/{id}.dsds.yaml using the template below.
4. 4Add a refs entry (rel: file) in index.dsds.yaml pointing at the new file.
5. 5Run npx dsds-validate {directory}/{id}.dsds.yaml — fix errors until it passes. Run npx dsds-lint {directory}/{id}.dsds.yaml for advisory…
6. 6Keep the template's field order. It follows the style guide, which asks you to write an entry's fields in the order the schema files list…
7. 7If your project generates its own index or catalog from these documents, regenerate it now.

What it can do on your machine

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

  Shell commands in SKILL.md call:

  • npx

  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:

  • designsystemdocspec.org

  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

Dsds Add loads about 1.7k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 718 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~59

When it runs · the whole SKILL.md, loaded when a task matches

~1.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

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 somerandomdude/design-system-documentation-schema at commit 52790fe, republished under its Apache-2.0 licence (© somerandomdude). 718 words, ~1,732 tokens.

name

dsds-add

description

Author a new Design System Doc Spec (DSDS) spec from component implementation, Figma design, or written requirements. Triggers on "add spec", "create spec", "new spec", "author spec", "spec from component", "spec from Figma".

metadata.version

0.21.2

kind: component
id: <filename-without-extension>
name: <PascalCase>
description: <one-sentence summary>

metadata:
  tags: [<action|feedback|form|disclosure|overlay|navigation|layout>]
  since: <version>
  status: {status: draft}

sections:
  - kind: guidelines
    for: all
    framing: when-to-use
    items:
      - level: should
        statement: <when this component is the right choice>
  - kind: guidelines
    for: all
    items:
      - level: must
        statement: <a rule for using it correctly>
        checkedBy: manual

sourceFiles:
  - platform: <react|web-component|...>
    file: <path to the real source file>

imports:
  - platform: <react|web-component|...>
    code: <import statement, written out>
    package: <package name>

traits:
  - traitType: variant
    kind: enum
    id: <the real prop or attribute name>
    description: <what this dimension controls>
    values:
      - id: <value name, as the API spells it>
        description: <what this value is for>

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

Files

Just SKILL.md in .agents/skills/dsds-add of somerandomdude/design-system-documentation-schema.

Open the folder on GitHubat commit 52790fe