skill

From the files and frontmatter at commit b19db04. This is how much a skill can do, not whether it is risky.

• Runs shell commands

  Its instructions or files give the agent commands to run on your computer.

Pattern check: nothing flagged · commit b19db04 · 3 Nov 2026

We checked every text file in this skill, at commit b19db04 on 3 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.

How the check worksReport an incorrect finding

Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.

• Agent Skills specFails

  The open format from agentskills.io, held to the strictest version of each rule among the agents we check.

  • Error

    Line 3: the description value contains a colon followed by a space, which YAML reads as the start of another field. Strict YAML parsers, including the spec's validator, reject the file. F4

    Fix: Put the value in quotes, like this: description: 'Build a construct — an animated, audited holographic model — of a real or fictional o…

  • Error

    The name is a map, not text. The spec requires text. N1

    Fix: Add name: skill.

  • Warning

    The body is about 5,617 tokens (approx.); the spec suggests under 5,000. B2

    Fix: Move detail into reference files that the agent reads only when needed.

  • Note

    There is no license field, so readers can't tell whether they may reuse the skill. O2

    Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.

  • Note

    Reference files that SKILL.md doesn't link: references/method.md. Anthropic suggests linking every reference file directly from SKILL.md. B4

    Fix: Link each one from SKILL.md and say when to read it.

  • Note

    Reference files over 100 lines with no table of contents at the top: references/craft.md (144 lines), references/effort.md (170 lines), references/review.md (144 lines), references/rounds.md (130 lines) and references/vocabulary.md (215 lines). B5

    Fix: Add a short list of the sections at the top of each.

• Claude CodePasses

  Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.

  • Note

    Line 3: the description value contains a colon followed by a space, which YAML reads as the start of another field. Claude Code quotes the value itself and loads the skill, but other agents reject it. F4

    Fix: Put the value in quotes, like this: description: 'Build a construct — an animated, audited holographic model — of a real or fictional o…

  • Note

    The name is a map, not text. Claude Code expects text here. N1

    Fix: Add name: skill.

  • Note

    The body is about 5,617 tokens (approx.); the spec suggests under 5,000. After compaction Claude Code keeps only the first 5,000 tokens of a skill. B2

    Fix: Move detail into reference files that the agent reads only when needed.

  • Note

    Reference files that SKILL.md doesn't link: references/method.md. Anthropic suggests linking every reference file directly from SKILL.md. B4

    Fix: Link each one from SKILL.md and say when to read it.

  • Note

    Reference files over 100 lines with no table of contents at the top: references/craft.md (144 lines), references/effort.md (170 lines), references/review.md (144 lines), references/rounds.md (130 lines) and references/vocabulary.md (215 lines). B5

    Fix: Add a short list of the sections at the top of each.

• Claude apps & API uploadFails

  Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.

  • Error

    Line 3: the description value contains a colon followed by a space, which YAML reads as the start of another field. Anthropic's validator rejects it, so packaging and upload fail. F4

    Fix: Put the value in quotes, like this: description: 'Build a construct — an animated, audited holographic model — of a real or fictional o…

  • Error

    The name is a map, not text. Anthropic's validator stops with "Name must be a string". N1

    Fix: Add name: skill.

  • Note

    The description is 1002 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4

    Fix: If the claude.ai upload refuses it, trim the description to 200 characters.

  • Note

    The body is about 5,617 tokens (approx.); the spec suggests under 5,000. Anthropic's guidance says the same. B2

    Fix: Move detail into reference files that the agent reads only when needed.

  • Note

    Reference files that SKILL.md doesn't link: references/method.md. Anthropic suggests linking every reference file directly from SKILL.md. B4

    Fix: Link each one from SKILL.md and say when to read it.

  • Note

    Reference files over 100 lines with no table of contents at the top: references/craft.md (144 lines), references/effort.md (170 lines), references/review.md (144 lines), references/rounds.md (130 lines) and references/vocabulary.md (215 lines). B5

    Fix: Add a short list of the sections at the top of each.

• OpenAI (Codex & API)Fails

  Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.

  • Error

    Line 3: the description value contains a colon followed by a space, which YAML reads as the start of another field. Codex quotes the value and loads the skill, but OpenAI's upload follows the spec, which needs valid YAML. F4

    Fix: Put the value in quotes, like this: description: 'Build a construct — an animated, audited holographic model — of a real or fictional o…

  • Error

    The name is a map, not text. OpenAI's upload follows the spec, which requires text. N1

    Fix: Add name: skill.

• VS Code & CopilotPasses with warnings

  VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.

  • Warning

    Line 3: the description value contains a colon followed by a space, which YAML reads as the start of another field. VS Code's own YAML reader still loads the skill, but may read some values differently. F4

    Fix: Put the value in quotes, like this: description: 'Build a construct — an animated, audited holographic model — of a real or fictional o…

  • Warning

    The name is a map, not text. VS Code uses the folder name when the name differs from it. N1

    Fix: Add name: skill.

12 files