guild skill - Guild

Create and manage reusable skill packages. Each subcommand has its own section below, in alphabetical order. See Skills for a full guide. Most commands take a skill identifier: a skill ID or a full name such as myorg~tone-guide. If you pass a bare name, add --owner to name the owner account.

create

Create a new skill. Name the owner with --owner or as part of the name. Otherwise the CLI uses GUILD_OWNER_ID or your default_owner setting, then asks you to pick an account. In non-interactive mode with no owner set, it uses your personal account if you belong to no organizations, and fails if you do.

guild skill create myorg~my-skill                       # Create a skill under myorg
guild skill create my-skill --owner myorg               # Same, with --owner
guild skill create myorg~my-skill --overview "..."      # Create with an overview

If you leave out --overview in an interactive terminal, the CLI prompts for it. The overview is optional.

Option	Description
`--overview <text>`	A brief description of what the skill does.
`--owner <account>`	The owner account name or ID.
`--public`	Make the skill visible to all users.

Argument	Description
`<name>`	The skill name, or `owner~name` such as `myorg~my-skill`.

get

Show a skill’s details, including its visibility, owner, and latest version.

guild skill get <identifier>                 # Get skill details
guild skill get <identifier> --mode json     # Emit the raw JSON payload

Option	Description
`--owner <account>`	The owner account name or ID.

Argument	Description
`<identifier>`	The skill ID or full name, such as `myorg~tone-guide`.

list

List the skills an account owns. By default, it lists only unarchived skills.

guild skill list                             # List unarchived skills
guild skill list --archived                  # List only archived skills
guild skill list --search "tone"             # Filter by name or overview
guild skill list --owner myorg --sort updated

Option	Description
`--archived`	Show only archived skills.
`--limit <number>`	The number of results to return. Defaults to `20`.
`--offset <number>`	The offset for pagination. Defaults to `0`.
`--owner <account>`	The owner account name or ID. Defaults to your configured owner, then to your personal account.
`--search <query>`	Search skills by name or overview.
`--sort <field>`	Sort by `name`, `updated`, or `newest`. Defaults to `name`.

search

Search skills by keyword.

guild skill search "compliance"              # Search skills by keyword
guild skill search "tone" --published        # Only show published skills
guild skill search "tone" --sort name        # Sort results by name

Option	Description
`--limit <number>`	The number of results to return. Defaults to `20`.
`--offset <number>`	The offset for pagination. Defaults to `0`.
`--published`	Show only published skills.
`--sort <field>`	Sort by `updated`, `newest`, or `name`. Defaults to `updated`.

Argument	Description
`<query>`	The search query.

unarchive

Restore an archived skill.

guild skill unarchive <identifier>

Option	Description
`--owner <account>`	The owner account name or ID.

Argument	Description
`<identifier>`	The skill ID or full name, such as `myorg~tone-guide`.

update

Update a skill’s overview or visibility. Pass at least one of --overview, --public, or --no-public.

guild skill update <identifier> --overview "New description"
guild skill update <identifier> --public     # Make public
guild skill update <identifier> --no-public  # Make private

Option	Description
`--no-public`	Make the skill private.
`--overview <text>`	The new skill overview.
`--owner <account>`	The owner account name or ID.
`--public`	Make the skill visible to all users.

Argument	Description
`<identifier>`	The skill ID or full name, such as `myorg~tone-guide`.

version

Create and inspect skill versions.

version create

Create a new version of a skill. In an interactive terminal, the CLI prompts for any value you leave out, and opens your editor for the body. Otherwise, you must pass --version-number, --description, and either --body or --body-file.

guild skill version create <identifier> \
  --version-number 1.0.0 \
  --description "Runtime description" \
  --body-file content.md                     # Create a version from a file

Option	Description
`--body <text>`	The skill’s Markdown body.
`--body-file <path>`	Read the body from a file. Takes precedence over `--body`.
`--description <text>`	A brief description of this version.
`--owner <account>`	The owner account name or ID.
`--version-number <semver>`	The semantic version number, such as `1.0.0`.

Argument	Description
`<identifier>`	The skill ID or full name, such as `myorg~tone-guide`.

version get

Show a skill version’s details.

guild skill version get <version-id>

Argument	Description
`<version-id>`	The skill version UUID.

version list

List a skill’s versions.

guild skill version list <identifier>
guild skill version list <identifier> --limit 50

Option	Description
`--limit <number>`	The number of results to return. Defaults to `20`.
`--offset <number>`	The offset for pagination. Defaults to `0`.
`--owner <account>`	The owner account name or ID.

Argument	Description
`<identifier>`	The skill ID or full name, such as `myorg~tone-guide`.

​archive

​create

​get

​list

​search

​unarchive

​update

​version

​version create

​version get

​version list

archive