How to use the Number Details agent skill: setup and examples

What is an agent skill and what does number-details do?

An agent skill is a folder containing a SKILL.md file with instructions that an AI agent loads when a task matches the skill's description. The skill tells the agent how to approach that kind of work; it does not run on its own.

The number-details skill has a single purpose. When a section needs process steps, feature groups, cards or a timeline, the agent adds small, low-contrast numbers like 01, 02, 03 beside headings, in card corners, along section gutters or on timeline rails. The numbers are meant to be secondary to the main content.

• Uses two-digit numbers such as 01, 02, 03 for consistency.
• Uses mono or narrow uppercase typography with low contrast so the detail feels architectural.
• Keeps spacing and alignment consistent across all numbered elements.
• Does not mix numbering styles within the same section.
• Keeps numbers from competing with headings or calls to action.

How to install the number-details skill

Download the ZIP file for the skill from this page and unzip it. The skill folder contains SKILL.md, plus a demo folder with demo/PROMPT.md and demo/source.json.

For a personal install, place the unzipped skill folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.

You can also upload the skill in the Claude apps by going to Settings → Capabilities → Skills.

• Personal install: ~/.claude/skills/ (available across your projects).
• Project install: .claude/skills/ inside the project folder (available only there).
• Claude apps: Settings → Capabilities → Skills, then upload the skill.

How to trigger the skill with natural requests

The agent loads the skill when your request matches its description, which covers decorative numeric markers for process steps, feature groups, cards or editorial rhythm. You can also name it directly. The demo prompt in the package uses the form $number-details at the start of a request.

Be specific about where the numbers should appear, since the skill's guidance names card corners, section gutters, timeline rails and beside-heading positions.

• "Use $number-details to add 01, 02, 03 markers to the four process steps on this landing page."
• "Add subtle numbered markers beside each feature heading in this section, using two-digit numbers."
• "Style the timeline cards with number-details markers in the top-left corner."

What to expect from the output

The skill guides the styling of numbers, not the content. Expect the agent to add markers in predictable positions, format them as two-digit numbers, and keep them visually quieter than headings and buttons.

Review the result for the points the guardrails stress: the numbers should not compete with headings or CTAs, and every numbered element in a section should share the same spacing and alignment.

• Check that headings and calls to action remain the most prominent elements.
• Check that the numbers match in style across the whole section.
• Check that the markers do not read as real content such as ordered instructions.

Safety notes: scripts and network access

According to the listing, number-details runs no scripts and uses no network access. It requires nothing else to be installed.

Because the skill is purely visual, the main risk is misuse rather than system access: decorative numbers can be mistaken for meaningful content if they are used where order or data matters.

• Runs scripts: no.
• Uses network: no.
• Requires: nothing listed.
• Licence: MIT.

Tips for better results

Give the agent the surrounding layout so it can place markers consistently. The demo prompt in the package shows a full brief, including page concept, purpose and content anchors.

Avoid this skill for content where numbers carry real meaning, and for interfaces that must meet strict accessibility requirements, because the low-contrast guidance can conflict with readability needs.

• Name the section and the element type (cards, timeline, headings).
• Ask for two-digit numbers and a single numbering style per section.
• Check contrast yourself after the agent styles the markers.