Inspect commands, templates, scripts, hooks, and their effective composition
stacks with the Specify CLI specify artifact command group. Requires
Specify CLI >= 1.0.7.
Prerequisite: needs the
specifyCLI. Ifspecify --versionfails, install it with the speckit-cli-setup skill first.
When to use
- List every command, template, script, and hook visible to a Spec Kit project.
- Explain which project, preset, extension, or built-in layer supplies an artifact.
- Inspect precedence, composition strategy, active layers, and hidden layers.
- Check whether declared hooks are registered and active.
- Resolve a stack entry back to the validated manifest contribution Spec Kit uses.
How to invoke
# Full artifact inventory, including composition stacks
specify artifact list --json
# Inspect one artifact by bare name or source-agnostic artifact id
specify artifact info <name> --json
specify artifact info <kind>:<name> --json
specify artifact info <name> --kind <command|template|script|hook> --json
# Resolve a manifest-backed stack layer to its effective contribution
specify artifact lookup <lookupId> --json
Identifiers
- An artifact
idhas the form<kind>:<name>, such ascommand:speckit.specify. Pass this value tospecify artifact info. - A stack entry's
lookupIdidentifies the preset or extension contribution behind that layer. Pass this opaque value unchanged tospecify artifact lookup. - Built-in layers do not have a
lookupId. Project or convention-only layers may not have a manifest contribution thatlookupcan resolve.
Notes
- All
specify artifactsubcommands are read-only. --jsonis currently required. A missing--jsonis a usage error.- Run commands from an initialized Spec Kit project containing
.specify/. listandinforeturn ordered stacks. For commands, templates, and scripts, index0is the winning layer. Hook stacks are additive, so multiple entries can be active.- Composition strategies are
replace,wrap,prepend,append, andadditivefor hooks. activeandhiddenare independent: an inactive layer can still participate in composed output unless a higherreplacelayer hides it.- Hook artifact ids percent-encode event and target-command components. Reuse ids and lookupIds exactly as returned instead of constructing them manually.