Skills & Marketplace
Skills are instruction files that give agents specialized knowledge. The Marketplace is a catalog of pre-built agents and skills you can install with one click.
Skills
What Are Skills?
A skill is a markdown file containing instructions, procedures, or domain knowledge. When an agent needs information covered by a skill, it loads the skill’s content into its context and follows the instructions within.
Skills let you codify team knowledge — standard operating procedures, style guides, troubleshooting runbooks, product specs — and make it available to any agent during a conversation.
How Agents Use Skills
During a conversation, an agent can load relevant skills on demand. The agent reads the skill’s markdown content and incorporates it into its response. This means:
- The agent follows procedures documented in the skill
- The agent applies domain-specific rules and constraints from the skill
- The agent references terminology and definitions from the skill
You do not need to manually tell the agent to use a skill. Agents discover and load skills automatically based on relevance to the current conversation.
Adding a Skill
There are four ways to add a skill to your workspace:
| Method | How |
|---|---|
| Upload | Upload a .md file from your computer |
| Build with Agents | Start a conversation with the skill creator agent, which helps you write a skill interactively |
| Import from GitHub | Provide a raw URL to a .md file in a GitHub repository |
| Install from Marketplace | Browse and install pre-built skills from the catalog (see Marketplace below) |
To upload a skill manually:
- Navigate to the Skills section in the sidebar
- Click Add Skill and select Upload
- Select a markdown file (
.md) from your computer - Give the skill a name and description
- Click Save
The skill is now available to agents in your workspace.
Skill Format
Skills are standard markdown files. A well-structured skill includes:
- A clear title describing the skill’s purpose
- Step-by-step instructions or reference material
- Examples where helpful
- Constraints or rules the agent should follow
# Creating AWS Private Offers
## Steps
1. Verify the buyer's AWS account ID
2. Confirm pricing terms with the sales team
3. Set the offer expiration date (default: 14 days)
4. Include a custom EULA if required by the buyer
## Rules
- Never create offers with more than 30% discount without VP approval
- Always include the standard support terms
- Expiration date must be at least 7 days from creation
Managing Skills
From the Skills section, you can:
- Edit — Update the skill’s name, description, or markdown content
- Delete — Remove a skill from your workspace
- Review — View the skill’s full content before making changes
Marketplace
What Is the Marketplace?
The Marketplace is a curated catalog of agents and skills built for common cloud marketplace workflows. It currently includes 20+ agents and 29 skills covering areas like document generation, CRM workflows, code review, meeting prep, and more. Instead of creating agents and skills from scratch, you can browse the catalog, find what you need, and install it directly into your workspace.
Installed items become part of your personal workspace — you can use them immediately in conversations, assign them to watches, or add them to channels.
Browsing the Catalog
Navigate to Marketplace in the Insulin sidebar to open the catalog.
Each catalog item shows:
- Name and description
- Type — Agent or Skill
- Category — The domain the item covers (e.g., sales, development, analytics)
- Featured badge — Highlighted items recommended by Suger
Filtering
Use the filters at the top of the catalog to narrow results:
| Filter | Options |
|---|---|
| Type | Agent, Skill |
| Category | Filter by domain category |
| Featured | Show only featured items |
Combine filters to quickly find what you need — for example, show only featured agents in the sales category.
Installing an Item
- Click on a catalog item to view its details
- Review the description, configuration, and conversation starters
- Click Install
That’s it. The agent or skill is copied into your workspace and ready to use.
What Gets Installed
When you install a catalog item, the following is copied into your workspace:
- System prompt — The instructions that define the agent’s behavior or the skill’s knowledge
- Configuration — Any pre-configured settings, such as which tools the agent can use
- Conversation starters — Suggested prompts to help you start using the agent or skill right away
- Icon — The visual identity of the item
Installed agents appear in your agent list. Installed skills appear in your skills list. You can customize them after installation — they are fully yours to edit.
Managing Installed Items
After installation, agents and skills from the marketplace behave identically to ones you create yourself. You can:
- Edit the system prompt or configuration
- Assign agents to watches or channels
- Attach skills to agents
- Delete items you no longer need
Discovering New Capabilities
The marketplace catalog is updated as new agents and skills are added. Check back periodically for new items, or filter by Featured to see the latest recommendations.