openagent-skills

Open-source agent skills for OpenAgent — connect Claude Code, Cursor, and other MCP-capable agents to your OpenAgent workspace with sensible defaults.

What's a skill?

A skill is a short, focused prompt that teaches an AI agent how to use a specific tool or product well. This repo bundles skills that pair with OpenAgent's MCP server so an agent using them doesn't have to rediscover the API surface every session.

Each skill lives in its own folder under skills/ and follows the agentskills.io SKILL.md convention:

• SKILL.md — the entry point the agent reads
• references/ — auxiliary docs the agent can consult on demand (endpoint tables, example queries, error catalog)

The skills

Skill	What it does
openagent-workspace-inspect	Read-only OpenAgent workspace queries: search conversations, fetch transcripts, look up visitors, inspect the AI's MCP audit trail, list agents / workflows / KB docs. Powered by OpenAgent's MCP server.

More coming. Contributions welcome.

Prerequisites

• An OpenAgent workspace with a Personal Access Token issued at Settings → Personal Access Tokens.
• An MCP-capable agent runtime. Anything that speaks Streamable HTTP MCP works:
  • Claude Code (claude mcp add)
  • Cursor (cursor://mcp/install deep link)
  • Claude Desktop
  • Anthropic Messages API mcp_servers parameter
  • Any custom client using @modelcontextprotocol/sdk

Quick start with Claude Code

# 1. Wire OpenAgent's MCP server into Claude Code
claude mcp add openagent \
  --transport http \
  --header "Authorization: Bearer oa_pat_..." \
  https://app.openagent.in/api/mcp/server

# 2. Install this skill
git clone https://github.com/JoinOpenAgent/openagent-skills.git ~/.claude/skills-src/openagent-skills
ln -s ~/.claude/skills-src/openagent-skills/skills/openagent-workspace-inspect ~/.claude/skills/

Now Claude Code knows how and when to reach for OpenAgent's tools without you re-explaining every session.

Quick start with any agent

Read the skill's SKILL.md file and paste it into your agent's system prompt (or its equivalent skill-loading mechanism). Everything the agent needs is in that one file plus its references/.

Contributing

New skills welcome, especially ones that:

• Combine OpenAgent tools with third-party MCP servers (Shopify + OpenAgent for e-commerce triage, Notion + OpenAgent for KB grounding, etc.)
• Solve a concrete support-ops workflow (VIP triage, refund-risk scoring, after-hours escalation reasoning)
• Wrap a specific reporting question that support leaders keep asking

Open a PR with your skill under skills/<your-skill-name>/SKILL.md. Keep skills short (under ~200 lines), focused on one job, and honest about failure modes.

License

MIT. See LICENSE.

Related

• OpenAgent — the hosted AI customer support platform: openagent.in
• OpenAgent MCP guide — openagent.in/guides/mcp-with-claude-code
• Model Context Protocol — modelcontextprotocol.io