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.
Installing Packages
Skills
A skill is aSKILL.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
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
2
Write your SKILL.md
Add the frontmatter and instructions as shown above.
3
Package and upload
Plugins
A plugin is TypeScript code that runs inside the gateway. It registers new tools viaapi.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:
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 —
doctorcommand validates connectivity - Risk tiers —
readonly-external,readwrite-external - Capability discovery — commands and resources declared in
connector.json
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.
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.
