Skip to content

rolecraft list ​

Show all installed skills.

Usage ​

bash
rolecraft list
rolecraft list --json
rolecraft list --agent <name>
rolecraft list -a <name>

Description ​

Displays every skill currently installed across all agent directories, along with their metadata (slug, name, source, target path).

--json ​

Output the skill list as JSON for machine consumption (scripts, CI, jq):

bash
rolecraft list --json | jq '.skills | keys'

--agent, -a <name> ​

Filter the output to show only skills installed to a specific agent:

bash
rolecraft list --agent cursor   # only skills installed to cursor
rolecraft list -a claude-code   # alias

Agent names are matched case-insensitively (e.g. --agent CURSOR matches cursor). When a filter is set, the header and summary lines include the matched agent, using the casing stored in the lockfile.

Node.js API ​

This command is also available as a programmatic function. See the Node.js API documentation for detailed usage.

js
import { list } from 'rolecraft'
const skills = await list()

See also ​