Gamut

Skillsets Overview

Understand what skillsets are in SuperAgent -- shared collections of skills backed by Git repositories that extend agent capabilities with reusable instructions, tools, and knowledge.

Skillsets are shared collections of skills backed by Git repositories. Each skill is a self-contained package of instructions, tools, and knowledge that teaches an agent how to perform a specific task -- such as reviewing an NDA, querying a database, or triaging support tickets.

By installing skills from a skillset, you give agents instant access to curated capabilities without having to build them from scratch.

What is a skill?

A skill is a directory containing a SKILL.md file and optionally supporting files (templates, reference data, configuration). The SKILL.md file uses YAML frontmatter to declare metadata and Markdown body content to provide the instructions that an agent follows when performing the task.

A typical SKILL.md looks like this:

---
name: NDA Review
description: Reviews NDAs for standard clause coverage and flags unusual terms.
metadata:
  version: 1.2.0
  required_env_vars:
    - name: LEGAL_DB_API_KEY
      description: API key for the legal document database
---
 
# NDA Review
 
When asked to review an NDA, follow these steps:
 
1. Extract all defined terms and party names.
2. Check for standard clauses: confidentiality, term, exclusions, remedies.
3. Flag any unusual or non-standard provisions.
...

The agent reads these instructions at runtime and follows them to carry out the task. Skills can also include auxiliary files alongside SKILL.md -- for example, a template.md with a standard output format or a reference-data.json with lookup tables.

What is a skillset?

A skillset is a Git repository that bundles multiple skills together under a shared index.json manifest. The manifest declares the skillset's name, description, version, and lists every skill available in the repository along with its path and version.

my-skillset/
  index.json
  skills/
    nda-review/
      SKILL.md
    supabase-query/
      SKILL.md
      schema-reference.json
    email-triage/
      SKILL.md
      templates/
        escalation.md

The index.json file provides the top-level metadata that SuperAgent reads when discovering available skills:

{
  "skillset_name": "Legal & Ops Skills",
  "description": "Shared skills for the legal and operations team.",
  "version": "2.1.0",
  "skills": [
    {
      "name": "NDA Review",
      "path": "skills/nda-review/SKILL.md",
      "description": "Reviews NDAs for clause coverage and flags unusual terms.",
      "version": "1.2.0"
    },
    {
      "name": "Supabase Query",
      "path": "skills/supabase-query/SKILL.md",
      "description": "Queries a Supabase database and returns formatted results.",
      "version": "1.0.0"
    }
  ]
}

Skill providers

SuperAgent supports three types of skill providers, each with different access and publishing models:

GitHub

The default provider. You register a skillset by providing its GitHub repository URL (HTTPS or SSH). SuperAgent clones the repository locally and keeps a cached copy that it refreshes when you pull updates.

GitHub skillsets support full collaboration: you can modify an installed skill locally, then submit your changes back to the upstream repository as a pull request. This makes it easy for teams to iterate on shared skills through standard code review workflows.

Requirements: Git must be installed. For private repositories, SSH authentication must be configured.

Platform

Platform-provided skillsets are managed through the SuperAgent platform. When you connect to a platform organization, any skillsets published by your organization are automatically synced to your local instance.

Platform skillsets use a hosted submission model instead of pull requests. When you modify a skill and submit changes, they go through the platform's review queue rather than creating a GitHub PR.

Requirements: An active platform connection with a valid organization.

Public

Public skillsets are read-only skill collections hosted on public GitHub repositories. SuperAgent downloads them as ZIP archives, so Git does not need to be installed. Public skillsets cannot be published to -- they are consume-only.

SuperAgent ships with a default public skillset that provides a starter collection of agent templates and skills.

How skills extend agents

When a skill is installed into an agent, its files are copied into the agent's workspace under .claude/skills/<skill-name>/. The agent reads the SKILL.md content as part of its context, gaining the instructions and knowledge contained in the skill.

Skills can declare required environment variables in their frontmatter metadata. These are secrets or configuration values that the skill needs at runtime -- for example, an API key for an external service. When you install a skill that requires environment variables, SuperAgent prompts you to provide them, and they are stored securely as agent secrets.

Next steps