Agent SkillsAgent Skills

Core Commands

Essential commands for managing skills

listshowvalidatepromptinit

list#

List all discovered skills from local and global directories.

Tip

Tip: Use skills list --json for programmatic access, or skills list --quiet to pipe skill names to other commands.

skills list [options]
OptionDescription
-p, --paths <paths...>Custom search paths
-v, --verboseShow detailed information
--jsonOutput as JSON
--tableOutput as ASCII table
-q, --quietOutput names only (for scripting)

Examples:

skills list                     # List all skills with names
skills list --json              # JSON array with name, description, path
skills list --table             # ASCII table with Name/Description columns
skills list --quiet             # Just names, one per line (pipe-friendly)
skills list -p ./my-skills      # Search custom path

Output (default):

Found 19 skill(s):

  xlsx
  skill-writer
  frontend-design
  ...

show#

Show detailed information about a specific skill.

skills show <name>

Example:

skills show xlsx

Output:

xlsx
────────────────────────────────────────
Description: Comprehensive spreadsheet creation...
Path: /Users/you/.antigravity/skills/xlsx
License: Proprietary

Instructions (preview):
# Requirements for Outputs
...

validate#

Validate a skill against the Agent Skills specification.

skills validate <path>

Examples:

skills validate ./my-skill         # Validate a local skill
skills validate skills/test-skill  # Relative path

Output (valid):

Validating: test-skill

Metadata:
✓ Valid

Body Content:
✓ Valid

────────────────────────────────────────
✓ Skill is valid

prompt#

Generate system prompt XML for discovered skills.

skills prompt [options]
OptionDescription
-f, --fullInclude full skill system instructions

Output:

<available_skills>
  <skill>
    <name>xlsx</name>
    <description>Comprehensive spreadsheet creation...</description>
    <location>/path/to/xlsx/SKILL.md</location>
  </skill>
  ...
</available_skills>

init#

Create a new skill from template with the standard directory structure.

skills init <name> [options]
OptionDescription
-d, --directory <dir>Directory to create skill in (default: ./skills)

Example:

skills init my-cool-skill
skills init my-cool-skill -d /tmp

Output:

✓ Created skill: my-cool-skill
  Path: ./skills/my-cool-skill

Next steps:
  1. Edit SKILL.md with your instructions
  2. Add scripts to scripts/
  3. Run: skills validate ./skills/my-cool-skill