Skip to content

Commit 98f5ba9

Browse files
author
Mark IJbema
authored
Merge pull request #12 from Kilo-Org/mark/mcp-modes-marketplace
add modes and mcps to marketplace
2 parents bce0127 + e735c32 commit 98f5ba9

3 files changed

Lines changed: 3126 additions & 23 deletions

File tree

README.md

Lines changed: 99 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,49 @@
11
<h1 align="center">Kilo Marketplace</h1>
22

3-
A curated list of practical Skills for enhancing productivity across the Kilo extensions, Kilo CLI, and the whole Kilo ecosystem.
3+
A curated collection of **Skills**, **MCP Servers**, and **Modes** for enhancing AI agent capabilities across the Kilo ecosystem—including Kilo Code (VS Code extension), Kilo CLI, and compatible AI agents.
4+
5+
---
6+
7+
## What is the Kilo Marketplace?
8+
9+
The Kilo Marketplace is a community-driven repository of agent tooling prompts and configurations. It provides three types of resources that extend what AI agents can do:
10+
11+
| Resource | Description |
12+
|----------|-------------|
13+
| **[Skills](#skills)** | Modular workflows and domain expertise that teach agents how to perform specific tasks |
14+
| **[MCP Servers](#mcp-servers)** | Standardized integrations that connect agents to external tools and services |
15+
| **[Modes](#modes)** | Custom agent personalities and behaviors with tailored tool access |
416

517
---
618

719
## Contents
820

9-
- [What Are Skills?](#what-are-skills)
10-
- [Creating Skills](#creating-skills)
21+
- [Skills](#skills)
22+
- [What Are Skills?](#what-are-skills)
1123
- [Skill Structure](#skill-structure)
12-
- [Basic Skill Template](#basic-skill-template)
13-
- [Skill Best Practices](#skill-best-practices)
24+
- [Creating Skills](#creating-skills)
25+
- [MCP Servers](#mcp-servers)
26+
- [What Are MCP Servers?](#what-are-mcp-servers)
27+
- [Modes](#modes)
28+
- [What Are Modes?](#what-are-modes)
1429
- [Contributing](#contributing)
15-
- [Quick Contribution Steps](#quick-contribution-steps)
1630
- [License](#license)
1731

18-
## What Are Skills?
32+
---
33+
34+
## Skills
35+
36+
### What Are Skills?
37+
38+
Skills are self-contained packages that extend an agent's capabilities with specialized knowledge and repeatable workflows. At their core, a skill is a folder containing a `SKILL.md` file with metadata and instructions that tell an agent how to perform a specific task.
1939

20-
Skills are customizable workflows that teach Kilo how to perform specific tasks according to your unique requirements. Skills enable Kilo to execute tasks in a repeatable, standardized manner across all Kilo platforms.
40+
Skills follow the open [Agent Skills specification](https://agentskills.io/), making them interoperable across any compatible AI agent—not just Kilo.
2141

22-
## Creating Skills
42+
**Key benefits:**
43+
- **Self-documenting**: Easy to read, audit, and improve
44+
- **Interoperable**: Works across any agent implementing the Agent Skills spec
45+
- **Extensible**: Can include scripts, templates, and reference materials
46+
- **Shareable**: Portable between projects and developers
2347

2448
### Skill Structure
2549

@@ -29,11 +53,14 @@ Each skill is a folder containing a `SKILL.md` file with YAML frontmatter:
2953
skill-name/
3054
├── SKILL.md # Required: Skill instructions and metadata
3155
├── scripts/ # Optional: Helper scripts
32-
├── templates/ # Optional: Document templates
33-
└── resources/ # Optional: Reference files
56+
├── references/ # Optional: Documentation
57+
├── assets/ # Optional: Templates, resources
58+
└── examples/ # Optional: Example files
3459
```
3560

36-
### Basic Skill Template
61+
### Creating Skills
62+
63+
**Basic Skill Template:**
3764

3865
```markdown
3966
---
@@ -53,39 +80,88 @@ Detailed description of the skill's purpose and capabilities.
5380

5481
## Instructions
5582

56-
[Detailed instructions for Kilo on how to execute this skill]
83+
[Detailed instructions for the agent on how to execute this skill]
5784

5885
## Examples
5986

6087
[Real-world examples showing the skill in action]
6188
```
6289

63-
### Skill Best Practices
64-
90+
**Best Practices:**
6591
- Focus on specific, repeatable tasks
6692
- Include clear examples and edge cases
67-
- Write instructions for Kilo, not end users
68-
- Test across Kilo VS Code extension, Kilo CLI, and API
93+
- Write instructions for the agent, not end users
6994
- Document prerequisites and dependencies
7095
- Include error handling guidance
7196

97+
---
98+
99+
## MCP Servers
100+
101+
### What Are MCP Servers?
102+
103+
MCP (Model Context Protocol) is a standardized communication protocol that allows AI agents to interact with external tools and services. Think of it as a universal adapter—any compatible agent can connect to any MCP server to access its functionality.
104+
105+
MCP servers provide capabilities like:
106+
- File system access
107+
- Database queries
108+
- API integrations
109+
- External service connections
110+
111+
**How it works:**
112+
1. The AI agent (client) connects to MCP servers
113+
2. Each server provides specific capabilities
114+
3. The agent uses these capabilities through a standardized interface
115+
4. Communication occurs via JSON-RPC 2.0 messages
116+
117+
MCP servers can run locally on your machine or remotely as cloud services, depending on security requirements.
118+
119+
Browse available MCP servers in the [`mcps/`](./mcps/) directory.
120+
121+
---
122+
123+
## Modes
124+
125+
### What Are Modes?
126+
127+
Modes are custom agent configurations that define specialized behaviors, personalities, and tool access. They allow you to create purpose-built agents for specific tasks like documentation writing, code review, or security analysis.
128+
129+
A mode defines:
130+
- **Role Definition**: The agent's identity and expertise
131+
- **Available Tools**: Which tool groups the agent can access
132+
- **File Restrictions**: Which files the agent can read or edit
133+
- **Custom Instructions**: Behavioral guidelines and rules
134+
135+
**Example use cases:**
136+
- A "Documentation Writer" mode that can only edit Markdown files
137+
- A "Security Reviewer" mode with read-only access for auditing
138+
- A "Test Engineer" mode focused on test files
139+
140+
Modes can be shared as YAML configurations and imported into Kilo Code or other compatible tools.
141+
142+
Browse available modes in the [`modes/`](./modes/) directory.
143+
144+
---
145+
72146
## Contributing
73147

74148
We welcome contributions! Please read our [Contributing Guidelines](CONTRIBUTING.md) for details on:
75149

76-
- How to submit new skills
77-
- Skill quality standards
150+
- How to submit new skills, MCP servers, or modes
151+
- Quality standards
78152
- Pull request process
79153
- Code of conduct
80154

81155
### Quick Contribution Steps
82156

83-
1. Ensure your skill is based on a real use case
84-
2. Check for duplicates in existing skills
85-
3. Follow the skill structure template
86-
4. Test your skill across platforms
157+
1. Ensure your contribution is based on a real use case
158+
2. Check for duplicates in existing resources
159+
3. Follow the appropriate structure template
160+
4. Test your contribution across platforms
87161
5. Submit a pull request with clear documentation
88162

163+
---
164+
89165
## License
90166

91167
This repository is licensed under the Apache License 2.0.

0 commit comments

Comments
 (0)