Skip to main content

​
Three Ways to Extend Your Agent

ArgentOS has three extension types, each serving a different purpose:

Skills

Teaches the agent how to do something. Injected as prompt instructions. No code runs.

Plugins

Adds new tools to the gateway runtime. Runs inside the gateway process.

Connectors

Wires to external APIs with auth and health checks. Runs as an isolated subprocess.
TypeWhat It DoesRuns WhereExample
SkillsTeaches the agent how to do somethingInjected as prompt instructionsDeep Research Pro, SEO Audit
PluginsAdds new tools to the gateway runtimeInside the gateway processThink Tank, VIP Email Alert
ConnectorsWires to external APIs with auth and health checksIsolated subprocessHubSpot, Google Workspace, Linear

​
Installing Packages

# Browse the marketplace
argent marketplace search hubspot

# Install a skill
argent marketplace install deep-research-pro

# Install a connector
argent connectors install aos-hubspot
Or browse visually at marketplace.argentos.ai.

​
Skills

A skill is a SKILL.md file — markdown instructions that tell your agent how to use an API, follow a workflow, or handle a specific task. No code runs. The agent reads the instructions and uses its existing tools to accomplish the task.

​
SKILL.md Format

---
name: my-skill
description: What this skill does and when to use it.
---

# My Skill

Instructions for the agent go here.

## When to Use
- User asks about X
- User wants to do Y

## How It Works
Step-by-step instructions, API endpoints, examples.
Required fields: name and description in the YAML frontmatter. The description is what triggers the skill — make it specific.

​
Creating a Skill

1

Create the skill directory

mkdir my-skill && cd my-skill
2

Write your SKILL.md

Add the frontmatter and instructions as shown above.
3

Package and upload

tar czf my-skill-1.0.0.tar.gz my-skill/
# Upload at marketplace.argentos.ai/submit

​
Plugins

A plugin is TypeScript code that runs inside the gateway. It registers new tools via api.registerTool(), hooks into agent events, and has full access to the runtime API. Plugins live at ~/.argentos/extensions/ and use an argent.plugin.json manifest: 
{
  "id": "my-plugin",
  "name": "My Plugin",
  "description": "What it does",
  "version": "1.0.0"
}
Plugins are more powerful but carry more risk — they execute code inside your gateway process. See Plugin Development for the full guide.

​
Connectors (AOS)

Connectors are production-grade integrations with external APIs. They run as isolated subprocesses with their own:
  • Authentication — service keys resolved through the secret store
  • Health checks — doctor command validates connectivity
  • Risk tiers — readonly-external, readwrite-external
  • Capability discovery — commands and resources declared in connector.json
Once installed, a connector’s actions become agent tools automatically.

​
Available Connectors

Google Workspace

Gmail, Drive, Calendar — 15 commands

HubSpot CRM

Contacts, deals, companies, tickets

QuickBooks

Invoices, payments, financial reports

Linear

Issues, projects, workflow management

Firecrawl

Web scraping and content extraction

Mailchimp

Email campaigns and audience management

WordPress

Content publishing and page management

Google Places

Local business search and discovery

​
Marketplace Security

Every package in the marketplace goes through three-layer security:
1

VirusTotal scan

Scanned by 70+ antivirus engines.
2

ArgentOS AI Safety

25 prompt injection patterns, secret detection, dangerous code checks.
3

Manual Review

The ArgentOS team reviews before publishing.
Packages with a “VT Scanned” badge link directly to the VirusTotal scan report.

​
Submitting to the Marketplace

1

Sign in

Sign in with GitHub at marketplace.argentos.ai/submit.
2

Upload package

Upload your .tar.gz package.
3

Fill details

Fill in display name, description, category, version, tags.
4

Submit for review

Submit — security scanning runs automatically. If scans pass, the team reviews and approves.
See the Marketplace for the full catalog.