Fastfold Docs
Agent CLI

Skills Commands

Discover, install, update, and remove skills from the Fastfold catalog and other sources.

Skills are reusable workflows (folding, MD, design, reporting) that the Agent CLI can run on demand. The CLI ships helper skills, and domain skills are installed from the Fastfold catalog.

Manage skills from shell

fastfold skills list
fastfold skills find [query]
fastfold skills add fastfold-ai/skills@skills/fold
fastfold skills add fastfold-ai/skills
fastfold skills upgrade
fastfold skills remove fold

Manage skills from interactive mode

/skills
/skills-find [query]
/skills-add <source>
/skills-upgrade
/skills-remove <name>

fastfold setup and /upgrade can also offer to install missing Fastfold skills automatically.

Versioning and updates

The Fastfold catalog is versioned with GitHub Releases (one semver tag per catalog version). The CLI uses that release to show versions and to notify you when a newer catalog is available.

  • See versions: fastfold skills list (and /skills) show Author, Updated, and Version columns. The version is the catalog's latest release tag (for example v1.0.0); the author is the source repo's org (for example fastfold-ai). Skills installed from a source without a release — such as npx-installed or bundled helper skills — show Version not available.
  • Upgrade: run fastfold skills upgrade (or /skills-upgrade) to sync the catalog, update installed skills, and record the latest release version.

On launch, the CLI shows a non-blocking notice when a newer catalog release exists:

Skills update available: v1.0.0 -> v1.1.0  Run /skills-upgrade

The check reads a local cache (no network on startup) and refreshes in the background, so it never slows boot. The notice appears on the next launch after a new release is published.

Last updated on

On this page