Agent & Skills
Stout is the first package registry with native support for AI agents, MCP servers,
and skill bundles. The skillctl CLI manages the full lifecycle.
Install skillctl
# macOS / Linux
curl -fsSL https://stout.io/install-skillctl.sh | sh
# Or with Go
go install github.com/jdziat/registry-server/cmd/skillctl@latest Login
Authenticate with your Stout instance:
skillctl login https://registry.stout.io
# Opens browser for OAuth (GitHub, GitLab, or Google) Search for Agents
# Search by keyword
skillctl search "code review"
# Filter by kind
skillctl search --kind mcp-server "database"
skillctl search --kind skill "testing" Install an Agent
# Install a skill
skillctl install myorg/code-reviewer@1.0.0
# Install an MCP server
skillctl install myorg/db-connector@2.1.0 --kind mcp-server
Before installing, skillctl displays the agent's permission tier so you
can review what access it requires.
Publish an Agent
Create an agent.yaml manifest in your repository:
# agent.yaml
kind: mcp-server
name: my-agent
version: 1.0.0
description: A helpful MCP server
permission_tier: network
entry_point: main.py
dependencies:
- python>=3.11
tools:
- name: fetch_data
description: Fetches data from an API
requires: network Then publish:
skillctl publish myorg https://github.com/myorg/my-agent v1.0.0 Stout clones the repo, validates the manifest, runs guardrail scanning (prompt injection, unicode trojans, code obfuscation), validates the permission tier, signs with Sigstore, and publishes the agent.
Verify an Agent
skillctl verify myorg/my-agent@1.0.0 Verifies the Sigstore signature, checks the transparency log entry in Rekor, and displays the publisher's verified identity.
Permission Tiers
| Tier | Access | Example Tools |
|---|---|---|
readonly | Read files only | Read, Glob, Grep |
filesystem | Read and write files | Read, Write, Edit |
execute | Run commands | Bash, shell scripts |
network | Network access | HTTP requests, WebSocket |
full | Unrestricted | All tools |
Agent Kinds
| Kind | Description |
|---|---|
skill | A single-purpose capability (e.g., code formatter, linter) |
mcp-server | An MCP-compatible server with tool declarations |
agent-bundle | A collection of skills and servers packaged together |