authoring-adept-skills — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited authoring-adept-skills (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A skill is a directory <root>/skills/<id>/ with one SKILL.md (YAML frontmatter + markdown body) and optional sidecars. adept renders it into every enabled harness, so write it once, well, and harness-neutral.
---
id: pr-review # ^[a-z0-9](?:[a-z0-9-]{0,48}[a-z0-9])?$ — matches the directory name
description: Use before opening a PR. Tests, security, performance. # <= 280 chars
activation: agent # always | globs | agent | manual
globs: [] # REQUIRED when activation: globs (e.g. ["**/*.go"])
allowed-tools: [Read, Grep] # carried into Claude Code
targets: [] # empty = all enabled harnesses
tags: [review, quality]
---
# PR Review Checklist
- [ ] Tests added or updated
- [ ] No secrets in the diffValidated against pkg/adeptschema/skill.schema.json on every load — adept sync fails loudly on a malformed skill, so let it catch your mistakes.
| activation | Fires when | Use for |
|---|---|---|
agent | The model decides from the description | Most skills. Procedures, checklists, how-tos. |
globs | A matching file is in context | Language/path-specific rules (**/*.go, **/*.tsx). |
always | Every request | Rare. Project-wide invariants only — costs budget on every turn. |
manual | Only when explicitly invoked | Heavy or destructive procedures you don't want auto-firing. |
For activation: agent, the description is the only thing the model sees when deciding whether to load the skill. Make it earn the load:
helper."*
— split it.
gets dropped first. Tighten prose; move long reference material into references/ sidecars.
exfiltrates secrets, or runs opaque remote code — it will flag (critical hard-blocks).
scripts/, references/, assets/) ride along to harnesses that supportthem; keep the SKILL.md body self-sufficient for those that don't.
adept skill add my-skill --edit # scaffold + open $EDITOR
adept sync # render to every enabled harness
adept status && adept diff # confirm it landed cleanRun adept skill --help (and adept skill add --help) for the current flags and subcommands — prefer it over memory; it never drifts. Edit canonical, adept sync, never hand-edit rendered files. See [[using-adept]] for the full CLI and [[adept-self-improve]] for turning a one-off lesson into a durable skill.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.