skills-catalog
Discover, search, and use skills from the Matimo Skills Catalog — browse provider skills, core skills, and user-created skills. USE THIS SKILL whenever the you(agent) asks what skills are available, wants to find a skill for a specific task, needs to understand what a skill does, or wants to browse the skill catalog.
- License 许可
- MIT
- 最近更新
- 2026-10-27
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- skills-catalog
- license
- MIT
- version
- 1.0.0
- metadata
- { "apply-to": "matimo_list_skills matimo_get_skill", "category": "Meta", "difficulty": "beginner" }
- description
- Discover, search, and use skills from the Matimo Skills Catalog — browse provider skills, core skills, and user-created skills. USE THIS SKILL whenever the you(agent) asks what skills are available, wants to find a skill for a specific task, needs to understand what a skill does, or wants to browse the skill catalog.
03 SKILL.md 正文
Skills Catalog
This skill teaches you how to discover, browse, and use skills from the Matimo Skills Catalog.
What Are Skills?
Skills are structured instructions (SKILL.md files) that teach agents HOW to use tools effectively. While tools define WHAT can be done, skills teach:
- When to use each tool
- How to combine tools into workflows
- What parameters to use for common scenarios
- How to handle errors and edge cases
- Best practices that produce the best results
Skill Sources
Matimo has three sources of skills:
1. Core Skills (Built-in)
Shipped with the Matimo SDK. Always available. Teach agents about Matimo itself.
| Skill | What It Teaches |
|---|---|
skill-creator |
How to create new skills at runtime |
skills-catalog |
How to discover and use skills (this skill) |
tool-discovery |
How to find and manage available tools |
tool-creation |
How to create new tool definitions |
meta-tools-lifecycle |
Tool lifecycle management |
policy-validation |
Policy and approval workflows |
2. Provider Skills
Bundled with provider packages. Teach agents how to use specific providers effectively.
| Provider | Skills | Focus |
|---|---|---|
| Slack | slack-channel-messaging, slack-channel-management, slack-user-interaction |
Messaging, channels, users |
| GitHub | github-pr-workflow, github-issue-management, github-repository-management, github-code-search |
PRs, issues, repos, search |
| Notion | notion-database-operations, notion-content-management |
Databases, pages |
| HubSpot | hubspot-contact-management, hubspot-deal-pipeline, hubspot-crm-entities |
CRM contacts, deals, entities |
| Gmail | gmail-email-sending, gmail-inbox-management |
Send/draft, search/read |
| Twilio | twilio-sms-messaging |
SMS, MMS, delivery tracking |
| Postgres | postgres-query-operations |
SQL queries, schema discovery |
| Mailchimp | mailchimp-campaign-management, mailchimp-audience-management |
Campaigns, subscribers |
3. User-Created Skills
Created at runtime by agents or users. Stored in ./matimo-tools/skills/ by default.
Discovering Skills
List All Available Skills
Use matimo_list_skills to get Level 1 metadata for all skills in a directory:
matimo_list_skills({
skills_dir: "./matimo-tools/skills"
})
Returns each skill's name, description, and optional metadata (license, category, difficulty).
Read a Specific Skill
Use matimo_get_skill for Level 2 activation — the full SKILL.md content:
matimo_get_skill({
name: "slack-channel-messaging",
skills_dir: "./matimo-tools/skills"
})
Returns the complete skill instructions plus a listing of any bundled resources.
Read Bundled Resources
Use matimo_get_skill with a file parameter for Level 3 access:
matimo_get_skill({
name: "my-skill",
file: "references/advanced-patterns.md"
})
Choosing the Right Skill
By Task Type
| Task | Skill to Use |
|---|---|
| Send a Slack message | slack-channel-messaging |
| Create a GitHub PR | github-pr-workflow |
| Query a database | postgres-query-operations |
| Send an email | gmail-email-sending |
| Send an SMS | twilio-sms-messaging |
| Create a marketing campaign | mailchimp-campaign-management |
| Manage CRM contacts | hubspot-contact-management |
| Create a Notion page | notion-content-management |
| Create a new skill | skill-creator |
| Find available tools | tool-discovery |
| Create a new tool | tool-creation |
By Category
| Category | Skills |
|---|---|
| Communication | slack-*, gmail-*, twilio-* |
| Developer Tools | github-*, postgres-* |
| CRM & Marketing | hubspot-*, mailchimp-* |
| Productivity | notion-* |
| Meta (Matimo) | skill-creator, skills-catalog, tool-*, policy-* |
Progressive Disclosure
Skills load in three levels to keep context efficient:
Level 1: Discovery (Always Visible)
- Name, description, category, difficulty
- Used to decide WHICH skill to activate
- Loaded via
matimo_list_skills
Level 2: Activation (On Trigger)
- Full SKILL.md body with workflows, examples, error handling
- Loaded via
matimo_get_skill - Contains everything needed to execute the skill
Level 3: Resources (On Demand)
- Scripts, reference docs, templates, assets
- Loaded via
matimo_get_skillwithfileparameter - Used for extended documentation or executable code
When to Load Each Level
- User asks "what can you do?" → Level 1: List skills with descriptions
- User asks to do a specific task → Level 2: Load the matching skill's full instructions
- Skill references a resource file → Level 3: Load the specific file on demand
Creating New Skills
Want to create a custom skill? Use the skill-creator skill. It guides you through:
- Capturing intent and requirements
- Interviewing for edge cases
- Writing the SKILL.md with proper frontmatter
- Validating against the Agent Skills spec
- Iterating based on feedback
matimo_get_skill({ name: "skill-creator" })
Skill Quality Indicators
When browsing skills, look for:
| Indicator | Good Sign |
|---|---|
| Specific description | Includes trigger phrases and use cases |
| Concrete examples | Real JSON examples with realistic parameter values |
| Error handling section | Documents common errors and recovery steps |
| Best practices | Practical tips beyond just parameter docs |
| apply-to field | Clearly linked to specific Matimo tools |
| Under 500 lines | Focused, uses references/ for overflow |
04 同仓库更多 Skills
twilio
Complete guide to all Twilio tools — text, media, delivery tracking, E.164 formatting, and message management.
slack
Complete guide to all Slack tools — messaging, channels, users, search, files, reactions, and threads.
postgres
Complete guide to all PostgreSQL tools — parameterized queries, schema navigation, data retrieval, and safe database interaction patterns.
notion
Complete guide to all Notion tools — databases, pages, blocks, queries, and content management.
mailchimp
Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.
hubspot
Complete guide to all HubSpot CRM tools — contacts, companies, deals, tickets, products, line items, pipelines, and entity management.