Commands

New Tricks: teach your agents new tricks. The design-time workbench for agent skills. This reference is generated from tricks --help for this release.

tricks [OPTIONS] <COMMAND>

Discover

Command	Description
`search`	Search skills across all catalogs
`info`	Catalog details and frontmatter of a skill: licence, risk, signals, files
`view`	Print a skill’s SKILL.md (or a supporting file), fetched without cloning; pipe it to render
`catalog`	Manage the catalogs search draws on
`try`	Try a skill that is not in your source repo: link it into this project (or user scope with –global)
`untry`	Remove trials: a skill’s, or those in this project (`--global`, `--to`, `--all`)

Skills in the source repo

Command	Description
`init`	Make the current git repository a source repo
`create`	Create a skill: scaffold it, or take it from an existing folder
`vendor`	Vendor an upstream skill into the source repo to customize it
`remove`	Remove a skill from the source repo (and its links)
`list`	Source repo skills and their state (outside a repo: registered source repos)

Work on skills

Command	Description
`experiment`	Experiment with a skill on its own branch and worktree: start, commit, merge or discard
`diff`	Compare versions of a skill in the source repo: experiments, branches, head, working, base

Upstream

Command	Description
`outdated`	Upstream changes to vendored skills, with a risk summary (fetches; changes nothing)
`update`	Merge upstream changes into vendored skills, keeping yours (left uncommitted)
`contribute`	Offer your change to a vendored skill back upstream as a pull request

Validate

Command	Description
`link`	Link source repo skills into agent directories to test them (all when none is named)
`unlink`	Remove links of source repo skills (all of this repo’s when none is named)
`lint`	Lint source repo skills (or a skill directory)

Ship

Command	Description
`publish`	Publish source repo skills to a distribution repository

Maintain

Command	Description
`doctor`	Check environment, credentials, agents and state
`upgrade`	Upgrade tricks to the latest release

Global options

Every command takes these.

Option	Description
`--json`	Machine-readable output
`--offline`	Never touch the network
`-y, --yes`	Answer yes to confirmations
`-q, --quiet`	Less progress output (and no echo of the git commands that change your repositories)
`-v, --verbose`	Also echo read-only git commands
`-h, --help`	Print help
`-V, --version`	Print version

With --json, commands print one JSON document on stdout (the shape the VS Code extension and agents read); human-readable progress and warnings go to stderr.