Harness artifact
File-native project continuity and engineering standards for coding agents.
npx -y skills add cekrauseee/harness --skill harness-artifactAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 23 days oldThe repository was created 23 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Create, update, index, and validate final user-facing HTML visualizations in docs/artifacts/. Use when a project needs a versioned architecture map, flow, comparison, report, or other inspectable HTML explanation rather than application UI or temporary agent output.
SKILL.md
2.6 KB, 476 tokens by cl100k_base, as published. Nobody here has run it
Harness Artifact
Create final documentation visualizations for project users. An artifact is versioned canonical documentation, not application code, a product prototype, or a draft.
Procedure
- Verify that HTML materially improves understanding over concise Markdown, a table, or Mermaid.
- Keep exploration and intermediate renders in the Harness workspace.
- Run
scripts/create_artifact.py <project-root> <slug> --title "<title>" --summary "<summary>"to create a neutral baseline and index entry. Use a lowercase kebab-case slug. - Replace the baseline body with a focused visualization derived from verified project sources.
- Keep the result at
docs/artifacts/<slug>.htmland its catalog entry indocs/artifacts/index.md. - Ensure
docs/index.mdroutes readers todocs/artifacts/index.md. - Run
scripts/check_artifacts.py <project-root>and fix every issue.
Artifact Contract
- Write visible content in simple, objective, coherent, and concise English.
- Produce static, self-contained HTML that opens directly from disk.
- Include
<!doctype html>,lang="en", UTF-8 metadata, a responsive viewport, a unique title, oneh1, and amainlandmark. - Use semantic HTML, keyboard-visible focus, sufficient contrast, and text alternatives for meaningful images.
- Use a neutral Harness presentation with system fonts and restrained layout styles.
- Keep CSS and any necessary script inline. Prefer HTML and CSS; use inline JavaScript only when it materially improves the explanation.
- Do not load fonts, styles, scripts, images, media, or data from external URLs.
- Do not use frameworks, package dependencies, build steps, analytics, or network calls.
- Do not copy project branding, colors, logos, or application interface patterns.
- Link to supporting canonical documentation when useful, but keep the visualization understandable on its own.
Boundaries
- Store drafts, generated source data, screenshots, and discarded variants in the Harness workspace, never in
docs/artifacts/. - Do not route final artifacts to a temporary output folder when they belong to the project documentation.
- Do not present an artifact as an implementation proposal unless the user explicitly requests that kind of documentation.
- Remove or update stale artifacts with the documentation change that invalidates them.
What ships with it: 3 files
10.0 KB alongside SKILL.md, 2 of them executable
agents/
- openai.yaml262 B
scripts/
- check_artifacts.pyruns6.0 KB
- create_artifact.pyruns3.8 KB