surfaces SKILL.md skillA

surfaces from camoa/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add camoa/claude-skills/surfaces@git:20261028.6aa4db5

Pins git:20261028.6aa4db5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
camoa/claude-skills
Path
aida/skills/surfaces/SKILL.md
Versions recorded
20
Latest version
git:20261028.6aa4db5, committed Oct 28, 2026
First version recorded
Sep 14, 2026
Size
10,625 bytes
Repository stars
33
License
MIT

This skill should be used when end to end or visual regression has to be set up for the current project, for example "set up e2e", "set up visual regression", "register a surface", "remove a surface", "take the first baselines", "add a page to the visual review", or when a stage's offer, at scope, design or review, gets a yes on a kind. It installs the harness from the framework's recipe, writes the surface file review runs, and takes first baselines with a person present.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Surfaces

Set up the surfaces review runs: end to end and visual regression. The framework decides how, and
that answer lives in a recipe outside this plugin. Setup takes no task folder, the way the tool
skill does. With no task active, it runs at the code path. Run from inside a task's worktree,
which is outside the code path, it runs there instead, so the setup ships with the task's branch. The
review skill runs the surfaces;
this skill only sets them up. The guards live in the script: `--confirmed` and `decline` refuse
unattended. This skill waits for a plain yes before `install`. So a stage's offer may invoke it.

Every call below runs `surfaces-actions.sh`, named in this skill's own grant, so it runs without
asking. Read the exit code first, never the text alone. Exit 1 means no project owns this
directory: say so, name the project skill, and stop.

## Determine the run mode

Read the active task's run mode. A task that states none is interactive, and so is a call with no
task active. Pass `--run-mode autonomous` on every call only when the task states it, or states `light`. Decide this
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add camoa/claude-skills/surfaces@sha256:e917de4cea4223d2

The line at the top of this page pins the label git:20261028.6aa4db5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_k4ww6gez4lqzzr6r.svg)](https://markdownregistry.com/a/art_k4ww6gez4lqzzr6r)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 20 versions of this file, between Sep 14, 2026 and Oct 28, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261028.6aa4db5 latest2026-10-28 6aa4db5 10,625 BA view · diff
git:20261028.a47b0512026-10-28 a47b051 10,697 BA view · diff
git:20261028.99198b42026-10-28 99198b4 10,623 BA view · diff
git:20261028.d87bb682026-10-28 d87bb68 10,588 BA view · diff
git:20261028.d6f6de32026-10-28 d6f6de3 10,588 BA view · diff
git:20261001.171b4262026-10-01 171b426 9,250 BA view · diff
git:20261001.2024e672026-10-01 2024e67 9,741 BA view · diff
git:20261001.2bea8422026-10-01 2bea842 8,399 BA view · diff
git:20260930.7a88d542026-09-30 7a88d54 8,031 BA view · diff
git:20260927.d9f0c162026-09-27 d9f0c16 8,027 BA view · diff
git:20260925.1f29c092026-09-25 1f29c09 7,836 BA view · diff
git:20260925.cf877b12026-09-25 cf877b1 7,812 BA view · diff
git:20260925.bc118062026-09-25 bc11806 7,812 BA view · diff
git:20260922.8115b362026-09-22 8115b36 7,793 BA view · diff
git:20260916.c26a4ac2026-09-16 c26a4ac 7,748 BA view · diff
git:20260915.1adef952026-09-15 1adef95 7,642 BA view · diff
git:20260914.f9211cf2026-09-14 f9211cf 7,619 BA view · diff
git:20260914.67f6e252026-09-14 67f6e25 7,549 BA view · diff
git:20260914.12b96c62026-09-14 12b96c6 7,521 BA view · diff
git:20260914.f2ec99a2026-09-14 f2ec99a 7,424 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10625 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

camoa/claude-skills · 33 stars · license MIT · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_k4ww6gez4lqzzr6r
GET https://markdownregistry.com/api/v1/resolve?ref=camoa/claude-skills/surfaces
GET https://markdownregistry.com/api/v1/blob/e917de4cea4223d2185e4bc3d1f5954e42ff3df62520bf9c9145e2fe57708c17

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from camoa/claude-skills

CLAUDE.md CLAUDE.md file
camoa/claude-skills · CLAUDE.md
git:20260913.cb6d62b · audit A · 33 stars
completion SKILL.md skill
camoa/claude-skills · aida/skills/completion/SKILL.md · This skill should be used when a reviewed task is ready to close, for example "close this task", "finish the task"…
git:20261028.4e82de7 · audit A · 33 stars
design SKILL.md skill
camoa/claude-skills · aida/skills/design/SKILL.md · This skill should be used when a task's criteria are grounded and it is time to decide how to build them, for example…
git:20261029.7834067 · audit A · 33 stars
implement SKILL.md skill
camoa/claude-skills · aida/skills/implement/SKILL.md · This skill should be used when a task's design has closed cleanly and it is time to begin building, for example "start…
git:20261028.aaa1221 · audit A · 33 stars
next SKILL.md skill
camoa/claude-skills · aida/skills/next/SKILL.md · This skill should be used when the user asks "what's next", "what should I work on", "continue", "resume", "pick up…
git:20261028.bd73fd1 · audit A · 33 stars
playbooks SKILL.md skill
camoa/claude-skills · aida/skills/playbooks/SKILL.md · This skill should be used when the user asks "which playbooks apply", "list the plays", "add a play", "capture this as…
git:20261028.99198b4 · audit A · 33 stars
project SKILL.md skill
camoa/claude-skills · aida/skills/project/SKILL.md · This skill should be used when the user asks "which project", wants to "create a project", "start a new project"…
git:20261028.99198b4 · audit A · 33 stars
research SKILL.md skill
camoa/claude-skills · aida/skills/research/SKILL.md · This skill should be used when a task's scope contract is approved and its criteria need grounding before design…
git:20261028.e2c6db6 · audit A · 33 stars
review SKILL.md skill
camoa/claude-skills · aida/skills/review/SKILL.md · This skill should be used when a task's implementation has finished and the whole task needs one pass against its…
git:20261028.6aa4db5 · audit A · 33 stars
scope SKILL.md skill
camoa/claude-skills · aida/skills/scope/SKILL.md · This skill should be used when a task needs its scope contract written or changed, for example "define scope", "write…
git:20261028.e2c6db6 · audit A · 33 stars
task SKILL.md skill
camoa/claude-skills · aida/skills/task/SKILL.md · This skill should be used when the user wants to "create a task", "start a new task", "split a task", "make this an…
git:20261028.aaa1221 · audit A · 33 stars
test-cleanup SKILL.md skill
camoa/claude-skills · aida/skills/test-cleanup/SKILL.md · This skill should be used when a project's test suite has grown too large and a person wants it analysed and cleaned…
git:20261028.dc2c7a5 · audit A · 33 stars

Every file in camoa/claude-skills

Browse by kind, by grade A, or by owner.