html-artifact-best-practices AGENTS.md

html-artifact-best-practices AGENTS.md is an instructions file for Codex, OpenCode from ClawEnable/html-artifact-best-practices. It costs 638 tokens per session, scanned A, original, Apache-2.0.

A set of repository instructions for creating and checking standalone HTML files—web pages that work from a single file without an app server.

In plain words
What is it for?
Use it when building or reviewing single-file HTML artifacts and when running the repository’s validator and tests.
Why use it?
It gives a coding agent the project’s file layout, coding rules, test commands, and checks for avoiding known mistakes.

Instructions file for CodexOpenCode

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 instructions/clawenable/html-artifact-best-practices/agents-md
Clone the repo
git clone --depth 1 https://github.com/ClawEnable/html-artifact-best-practices

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for html-artifact-best-practices AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/clawenable/html-artifact-best-practices/agents-md.svg)](https://agentmods.dev/instructions/clawenable/html-artifact-best-practices/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/clawenable/html-artifact-best-practices/agents-md"><img src="https://agentmods.dev/badge/instructions/clawenable/html-artifact-best-practices/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 638 This file is loaded in full into every session.
When invoked 638 The same file — it is already loaded in full.
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.00638 $0.00638
Opus 5 $0.00319 $0.00319
Sonnet 5 $0.00128 $0.00128
Haiku 4.5 $0.00064 $0.00064

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

Security

Grade A, and why

html-artifact-best-practices AGENTS.md 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 4d 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.md · 45 lines

How it starts

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

Repository Guidelines

Project Structure & Module Organization

This repository is a content-only Agent Skill package for standalone HTML artifacts. The distributable skill lives in skills/html-artifact-guide/.

  • skills/html-artifact-guide/SKILL.md defines triggers, workflows, output requirements, and anti-patterns.
  • skills/html-artifact-guide/references/ contains deeper guidance, including artifact patterns and the review checklist.
  • skills/html-artifact-guide/assets/standalone-template.html is the baseline single-file HTML template.
  • skills/html-artifact-guide/evals/trigger-scenarios.md documents manual trigger scenarios.
  • scripts/validate-artifact.js and tests/validate-artifact.test.js cover the validator.
  • docs/design-rationale.md, localized READMEs, and CONTRIBUTING.md support distribution and contribution context.

Build, Test, and Development Commands

There is no app build chain, install step, or runtime service. Use these checks before submitting changes:

node --test tests/validate-artifact.test.js
node scripts/validate-artifact.js skills/html-artifact-guide/assets/standalone-template.html tests/fixtures/valid-artifact.html
! rg "Replace with|<title></title>" skills/html-artifact-guide/assets tests/fixtures/valid-artifact.html
test "$(rg -c "expected_action" skills/html-artifact-guide/evals/trigger-scenarios.md)" -ge 20
git diff --check

For local installation testing, copy the skill contents with cp -r skills/html-artifact-guide/* ~/.codex/skills/html-artifact-guide/.

Coding Style & Naming Conventions

Most source files are Markdown. Use concise headings, direct instructions, and concrete pass/fail criteria. Keep examples framework-free: vanilla HTML, inline CSS, and vanilla JavaScript only. Do not reference React, Vue, Tailwind, CDNs, remote fonts, or external scripts. Use kebab-case filenames, such as review-checklist.md.

Testing Guidelines

Automated tests cover the validator with Node's built-in test runner. Manual review covers trigger behavior and content quality. When changing trigger language or the output contract, review SKILL.md, evals/trigger-scenarios.md, the template, the review checklist, and the validator for drift.

Read the full file on GitHub · 45 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. 4d ago First seen · 45 lines · 638 tokens per session scan A 8d03bba19135

Subscribe to this mod's changes

html-artifact-best-practices AGENTS.md is an instructions file published in the GitHub repository ClawEnable/html-artifact-best-practices (2 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 638 tokens to every session, about $0.0032 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-31.

Related

Other instructions, from other repositories

claude-code-karma CLAUDE.md

Instructions for JayantDevkar/claude-code-karma, covering claude.md, project overview, quick start, clone (no submodule init needed — this is a monorepo) and start api (terminal 1).

JayantDevkar/claude-code-karma · 2,168 tokens

Vibe-Research AGENTS.md

AGENTS.md instructions for simonlin1212/Vibe-Research, covering vibe-research-agent 金融研究宪法, 0. 三条不可越线, 1. 数据纪律(五问 gate:给出任何数字或结论前逐条自问), 2. 研究哲学(评估框架,不是预测工具) and 3. 估值口径(你只选输入、解释输出;计算交给 calc/).

simonlin1212/Vibe-Research · 4,469 tokens

agent-skills AGENTS.md

AGENTS.md instructions for magnus919/agent-skills, covering agents.md — agent guide for agent-skills, format compliance, readme format, required sections and style guidance.

magnus919/agent-skills · 3,275 tokens

gangsta AGENTS.md

Instructions for kucherenko/gangsta, covering contributing to gangsta, what this is, what will not be accepted, skill changes and the laws apply to contributors too.

kucherenko/gangsta · 276 tokens

gangsta GEMINI.md

Instructions for kucherenko/gangsta, a project described as: AI agentic skills framework for spec-driven development, built on the organizational model of mafia.

kucherenko/gangsta · 29 tokens

shisan-xinuo-workflow AGENTS.md

AGENTS.md instructions for zxc663/shisan-xinuo-workflow, covering 项目级 agent 规则 · shisan-xinuo-workflow(本仓库), 工作流在场(本仓库会话), 维护纪律(本 skill 正文 vs 史料——开发本 skill 时的写作规范), 项目承载(已就绪) and 本仓库底线(区别于通用纪律).

zxc663/shisan-xinuo-workflow · 1,016 tokens