Skills
Skills add focused practices that are more specific than Agentbriefer's general
project policy. They ship inside the CLI as validated SKILL.md documents.
Browse the catalog
agentbriefer skill list
agentbriefer skill list --role frontend
agentbriefer skill list --recommended
agentbriefer skill list --role security --recommended
Role and recommendation filters affect only the current listing. They never change the project's installed skills.
Inspect before installing
agentbriefer skill info no-secrets-in-repo
Info prints the name, ID, description, category, roles, compatible-stack tags, and full instruction body.
Add a skill
agentbriefer skill add no-secrets-in-repo
This operation:
- validates the ID against the bundled catalog;
- appends the ID to
agentbriefer.yaml; - materializes
.agentbriefer/skills/<id>/SKILL.md; - synchronizes every configured agent output.
Adding an installed skill again is a harmless no-op. Unknown IDs fail with a catalog hint.
Update installed skill content
agentbriefer skill update
Update re-materializes configured skills and synchronizes outputs using the catalog bundled in the currently installed CLI. It does not fetch a marketplace or contact a server; upgrade Agentbriefer first to receive newer bundled content.
Remove a skill
agentbriefer skill remove no-secrets-in-repo
Removal updates YAML, deletes stale materialized skill directories, and synchronizes outputs. Removing an absent ID warns and succeeds.
Source of truth
The IDs in agentbriefer.yaml are authoritative. Materialized SKILL.md files
contain a do-not-edit header and are replaced during update. Put project-specific
exceptions in custom_instructions, not inside generated skill files.
See the v1 skill catalog for every bundled ID.