Tool Details: skills_parse

Basic Information

Tool Name:skills_parse
Asset Name:Parse Skill
Description:Translates a SKILL.md (Anthropic Agent Skills format: YAML frontmatter plus a Markdown body) into Covia skill metadata without storing anything. Give either 'source' — one content reference such as file://<root>/<dir>/SKILL.md, dlfs/<drive>/<path> or a/<hash> — or 'text', the SKILL.md itself. Returns the metadata map that the lattice write and asset store operations accept as-is: frontmatter name and description become asset fields, tools/skills/skillsets become the skill facet, license and compatibility ride along, and any other frontmatter key is reported under 'ignored'. Use the skill-import operation to parse and store in one step. Read-only.
Adapter:skills
Asset Hash:0x5327cc2db0d8713a16190f48fd02960240ae2f8f97635a71e960c40783acc95d
Input
PropertyTypeDescription
sourcestringOne content reference to a SKILL.md: 'file://<root>/<dir>/SKILL.md', 'dlfs/<drive>/<path>', or an asset ref ('a/<hash>'). Mutually exclusive with 'text'.
textstringThe SKILL.md text itself, when it is already in hand. Mutually exclusive with 'source'.
contentstringHow the returned metadata carries the body: 'inline' (default) copies it into content.inline — self-contained; 'ref' binds content.ref to 'source' so the body stays live in the file (requires 'source').
Output

Type: object

Schema: <code>{ &quot;type&quot;: &quot;object&quot;, &quot;description&quot;: &quot;{metadata, name, description, ignored?}. &#x27;metadata&#x27; is the complete skill map — write it to w/skills/&lt;name&gt; with the lattice write operation, or store it with the asset store operation for an immutable a/&lt;hash&gt;. &#x27;ignored&#x27; lists frontmatter keys that have no Covia equivalent (for example allowed-tools or argument-hint) and were dropped. Fails when the text has no frontmatter, no description, or no name that can be derived from the source, or when the source does not resolve to content — a source that is already skill metadata is read with the skill-read operation instead.&quot; }</code>

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-4.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "skills_parse",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-4.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "skills_parse",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-4.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "skills_parse",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-4.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'skills_parse',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
	"name": "Parse Skill",
	"description": "Translates a SKILL.md (Anthropic Agent Skills format: YAML frontmatter plus a Markdown body) into Covia skill metadata without storing anything. Give either 'source' — one content reference such as file://<root>/<dir>/SKILL.md, dlfs/<drive>/<path> or a/<hash> — or 'text', the SKILL.md itself. Returns the metadata map that the lattice write and asset store operations accept as-is: frontmatter name and description become asset fields, tools/skills/skillsets become the skill facet, license and compatibility ride along, and any other frontmatter key is reported under 'ignored'. Use the skill-import operation to parse and store in one step. Read-only.",
	"dateCreated": "2026-08-27T00:00:00Z",
	"operation": {
		"adapter": "skills:parse",
		"toolName": "skills_parse",
		"input": {
			"type": "object",
			"properties": {
				"source": { "type": "string", "description": "One content reference to a SKILL.md: 'file://<root>/<dir>/SKILL.md', 'dlfs/<drive>/<path>', or an asset ref ('a/<hash>'). Mutually exclusive with 'text'." },
				"text": { "type": "string", "description": "The SKILL.md text itself, when it is already in hand. Mutually exclusive with 'source'." },
				"content": { "type": "string", "enum": ["inline", "ref"], "description": "How the returned metadata carries the body: 'inline' (default) copies it into content.inline — self-contained; 'ref' binds content.ref to 'source' so the body stays live in the file (requires 'source')." }
			}
		},
		"output": {
			"type": "object",
			"description": "{metadata, name, description, ignored?}. 'metadata' is the complete skill map — write it to w/skills/<name> with the lattice write operation, or store it with the asset store operation for an immutable a/<hash>. 'ignored' lists frontmatter keys that have no Covia equivalent (for example allowed-tools or argument-hint) and were dropped. Fails when the text has no frontmatter, no description, or no name that can be derived from the source, or when the source does not resolve to content — a source that is already skill metadata is read with the skill-read operation instead."
		}
	}
}

Navigation

Back to adapter details

Back to all adapters

Back to index