> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# guild skill

> Create and manage reusable skill packages.

Create and manage reusable skill packages. See [Skills](/cli/skills) for a full guide.

```bash theme={null}
guild skill create <name>                    # Create a new skill
guild skill create <name> --overview "..."   # Create with description
guild skill get <identifier>                 # Get skill details (name or UUID)
guild skill list                             # List skills (unarchived only)
guild skill list --archived                  # List only archived skills
guild skill list --search "tone"             # Search skills
guild skill search "compliance"              # Search skills by keyword
guild skill search "tone" --published        # Only show published skills
guild skill update <identifier> --overview "New description"
guild skill update <identifier> --public     # Make public (requires admin)
guild skill archive <identifier>             # Archive the skill
guild skill unarchive <identifier>           # Restore an archived skill
```

## versions

```bash theme={null}
guild skill version create <identifier> \
  --version-number 1.0.0 \
  --description "Runtime description" \
  --body-file content.md                     # Create a version from file

guild skill version list <identifier>        # List versions
guild skill version get <version-id>         # Get version details
```