authoring-patterns

Guidance for turning validated HTML compositions into reusable .examples.ts pattern files in the Elements pattern library. It covers locating the template, checking it, and following the library's example conventions.

In plain words
What is it for?
Use it when saving a playground template, prototype, or HTML composition to the pattern library.
Why use it?
It helps preserve working prototypes as organized, reusable patterns instead of leaving them as one-off code.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nvidia/elements/authoring-patterns
Any agent
npx skills add NVIDIA/elements --skill authoring-patterns
Clone the repo
git clone --depth 1 https://github.com/NVIDIA/elements

Made for: Claude Code, Codex.

Per session 106 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,633 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00106 $0.01633
Opus 5 $0.00053 $0.00816
Sonnet 5 $0.00021 $0.00327
Haiku 4.5 $0.00011 $0.00163

Measured 2d ago against content hash b7a49ba565f7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

authoring-patterns scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/authoring-patterns/SKILL.md · 195 lines

How it starts

The opening of the file, as written. The whole thing — 195 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Authoring Patterns

Persist a validated HTML template as a reusable pattern file in the Elements pattern library at projects/internals/patterns/src/.

When to Use This Skill

  • User wants to save a playground template as a reusable pattern
  • User asks to persist, save, or store a composition in the codebase
  • User wants to create a new pattern file from HTML
  • User says "save as pattern," "create pattern," or "add to pattern library"
  • User has a validated playground prototype and wants it cataloged

Must Read Files

You MUST review these files before proceeding:

  • Examples Guidelines -- authoritative rules for naming, @summary, and structure
  • Scan projects/internals/patterns/src/*.examples.ts to understand existing patterns and categories

Workflow

Phase 1: Locate Template

Find the validated HTML template to persist. Look for it in the conversation context:

  1. Check for a recently validated HTML template from a playground workflow
  2. Check for HTML the user has pasted or referenced
  3. If no template exists, ask the user to provide the HTML they want to save

Phase 2: Check Validity

Ensure the template is valid before proceeding.

  1. Call api_validate with { template, lang: 'html', format: 'json' }
  2. If validation returns errors, report them to the user and fix each issue
  3. Re-validate until ok is true and summary.errors is 0
  4. Do NOT proceed to Phase 3 until validation passes

Phase 3: Generate Imports

Use the MCP tool to derive correct ESM import statements.

  1. Call api_imports_get with the template HTML
  2. The tool returns the required @nvidia-elements/core/*/define.js imports
  3. Always prepend import { html } from 'lit'; as the first import -- the tool does not include it

Phase 4: Determine Metadata

Analyze the template and determine where and how to file it.

Export name:

  • PascalCase, 1-3 words (per examples.md guidelines)
  • Describes WHAT the pattern shows, not HOW it works
  • Avoid component names in the title (use LoginForm not InputPasswordLoginForm)

Read the full file on GitHub · 195 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 195 lines · 106 tokens per session scan A b7a49ba565f7

Subscribe to this mod's changes

authoring-patterns is a skill published in the GitHub repository NVIDIA/elements (83 stars, last pushed 2d ago), licensed Apache-2.0. It adds 106 tokens to every session and 1,633 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

design-doc-interviewer

Interview the user to turn a proposed product/engineering change into a structured design document. Use when the user asks to be interviewed, wants help clarifying a design, or wants a design doc produced from Q&A. Emphasize numbered questions (few at a time), capture requirements/constraints/UX/data/logic/testing…

liveloveapp/hashbrown · 77 tokens

ideate

Capture and document a new idea in this repo. Use when the user says things like "help me brainstorm", "I have an idea", or "let's capture this for the future" and wants it recorded in design/ideas/ with a summary, supporting research (repo context + web if useful), and a sketch.

liveloveapp/hashbrown · 70 tokens

beui

Pick and install beUI (@beui) animated React components from the shadcn registry. Use when building motion UI, agent/chat interfaces, toasts, docks, bottom sheets, drawers, popovers, sliders, loaders, 404 pages, or any beui.dev component. Maps user intent to exact @beui install slugs instead of inventing custom…

starc007/ui-components · 78 tokens

beui-pro

Choose, inspect, install, and compose licensed beUI Pro premium React blocks from the authenticated shadcn registry. Use when building or improving landing pages with beUI Pro, installing @beui-pro items, selecting premium heroes, features, pricing, social proof, CTAs, navigation, footers, or other page sections, or…

starc007/ui-components · 83 tokens

ui-development

Build UI pages and extensions for Falcon Foundry apps using React or Vue with the Shoelace design system and Foundry-JS. TRIGGER when user asks to "create a UI page", "build a UI extension", "add a Shoelace component", "call an API from the UI", runs foundry ui pages create or foundry ui run, or needs help with Vite…

CrowdStrike/foundry-skills · 113 tokens

vue-application-structure

Establishes or reviews the directory layout, component conventions, composable design, Pinia store structure, and Vue Router configuration for a Vue 3 TypeScript application. Invoked when the user asks to structure a Vue app, set up the project layout, or review Vue architecture.

soulcodex/agentic · 63 tokens