asset-frontmatter-checklisted
Install: claude install-skill MarieLynneBlock/arcanum-artifex
# Asset Frontmatter Check
Check that a customisation asset carries the frontmatter this repository expects, then report or fix deviations.
## When to use
- A new asset was added under `skills/`, `workflows/`, `agents/`, `instructions/`, or `templates/`.
- An asset is ignored by VS Code and the frontmatter is the suspect.
- A review asks whether assets follow repository conventions.
## Required shapes
Field order matters where shown.
**`SKILL.md`**
```yaml
---
name: (kebab-case name matching the folder)
description: (what it does and when to use it)
metadata:
skill-author: (author name)
version: x.x.x
---
```
**`WORKFLOW.md`**
```yaml
---
name: (kebab-case name matching the folder)
description: (what it does and when to use it)
metadata:
workflow-author: (author name)
version: x.x.x
---
```
**`*.agent.md`**
```yaml
---
description: (discovery-friendly description)
metadata:
agent-author: (author name)
version: x.x.x
---
```
Keep `name`, `tools`, and `model` only when they add clear value.
**`*.instructions.md`**
```yaml
---
description: (description)
applyTo: (glob)
metadata:
instruction-author: (author name)
version: x.x.x
---
```
`metadata` is the last field when present.
## Procedure
1. Identify the asset type from the file name and location.
2. Read the frontmatter block only; do not rewrite body content.
3. Check, in order:
- Frontmatter opens on line 1 with `---` and