@agiflowai/one-mcp 0.2.6 → 0.2.7

package/README.md

@@ -259,9 +259,51 @@ When multiple paths are configured, skills from earlier paths take precedence ov
 
 You can also convert MCP server prompts into skills. This allows you to expose prompts from MCP servers as executable skills that AI agents can invoke.
 
-#### Configuration
+#### Auto-Detection from Front-Matter (Recommended)
+
+The easiest way to create prompt-based skills is to add YAML front-matter directly in your prompt content. one-mcp automatically detects prompts with `name` and `description` front-matter and exposes them as skills.
+
+**Prompt content with front-matter:**
+```markdown
+---
+name: code-reviewer
+description: Review code for best practices and potential issues
+---
 
-Add a `prompts` section under a server's `config`:
+# Code Review Instructions
+
+When reviewing code, follow these guidelines...
+```
+
+MCP servers like `@agiflowai/scaffold-mcp` support the `--prompt-as-skill` flag to automatically add front-matter to prompts:
+
+```yaml
+mcpServers:
+  scaffold-mcp:
+    command: npx
+    args:
+      - -y
+      - "@agiflowai/scaffold-mcp"
+      - "mcp-serve"
+      - "--prompt-as-skill"  # Enables front-matter in prompts
+```
+
+**Multi-line descriptions** are supported using YAML block scalars:
+
+```markdown
+---
+name: complex-skill
+description: |
+  A skill that does multiple things:
+  - First capability
+  - Second capability
+  - Third capability
+---
+```
+
+#### Explicit Configuration (Alternative)
+
+You can also explicitly configure which prompts should be exposed as skills:
 
 ```yaml
 mcpServers:
@@ -286,14 +328,14 @@ mcpServers:
 
 #### How Prompt-Based Skills Work
 
-1. **Configuration**: Define which prompts should be exposed as skills in the server config
-2. **Discovery**: Prompt-based skills appear alongside file-based skills in `describe_tools`
+1. **Discovery**: one-mcp scans all prompts from connected servers for front-matter with `name` and `description`
+2. **Fallback**: Explicitly configured prompts (in `config.prompts`) take precedence over auto-detected ones
 3. **Invocation**: When an AI agent requests a prompt-based skill, one-mcp:
    - Fetches the prompt content from the MCP server
    - Returns the prompt messages as skill instructions
 4. **Execution**: The AI agent follows the skill instructions
 
-#### Skill Configuration Fields
+#### Skill Configuration Fields (Explicit Config)
 
 | Field | Required | Description |
 |-------|----------|-------------|
@@ -301,6 +343,12 @@ mcpServers:
 | `description` | Yes | Brief description of what the skill does |
 | `folder` | No | Optional folder path for skill resources |
 
+#### Skill Naming and Precedence
+
+- **File-based skills** take precedence over prompt-based skills with the same name
+- Skills are only prefixed with `skill__` when they clash with MCP tool names
+- Skills that only clash with other skills are deduplicated (first one wins, no prefix)
+
 #### Example Use Case
 
 Convert a complex prompt from an MCP server into a reusable skill:

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_http = require('./http-xSfxBa8A.cjs');
+const require_http = require('./http-B4NAfsQl.cjs');
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let liquidjs = require("liquidjs");
@@ -548,7 +548,7 @@ const initCommand = new commander.Command("init").description("Initialize MCP co
 
 //#endregion
 //#region package.json
-var version = "0.2.5";
+var version = "0.2.6";
 
 //#endregion
 //#region src/cli.ts

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as findConfigFile, c as ConfigFetcherService, i as createServer, n as SseTransportHandler, o as SkillService, r as StdioTransportHandler, s as McpClientManagerService, t as HttpTransportHandler } from "./http-D9BDXhHn.mjs";
+import { a as SkillService, c as ConfigFetcherService, i as createServer, n as SseTransportHandler, o as findConfigFile, r as StdioTransportHandler, s as McpClientManagerService, t as HttpTransportHandler } from "./http-DSkkpGJU.mjs";
 import { writeFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { Liquid } from "liquidjs";
@@ -548,7 +548,7 @@ const initCommand = new Command("init").description("Initialize MCP configuratio
 
 //#endregion
 //#region package.json
-var version = "0.2.5";
+var version = "0.2.6";
 
 //#endregion
 //#region src/cli.ts