Skip to content

rolecraft use ​

Preview a skill's files without installing.

Usage ​

bash
rolecraft use <source>
rolecraft use <source> --list
rolecraft use <source> --skill <name>

Description ​

Resolves the source, shows metadata, and prints all file contents to stdout — without writing anything to disk. Useful for inspecting a skill before installing, or piping content into other tools.

Options ​

FlagDescription
--listList available skills without previewing content
--skill <names>Preview specific skills by name (comma-separated)

Examples ​

bash
# Preview a local skill
rolecraft use ./my-skill

# Preview a GitHub skill
rolecraft use sametcelikbicak/coverage-guard

# Pipe content
rolecraft use ./my-skill | head -50

Node.js API ​

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

js
import { use } from 'rolecraft'
const preview = await use('./my-skill')

See also ​