Adapter Details: skills

Discover and import agent skills — named bundles of instructions, context, tools, and further skills. Read-only: list the skills in a skillset (a directory of skills, such as w/skills or v/skills/data), read one skill in full by its resolved path or asset ref, and parse a SKILL.md (Anthropic Agent Skills format) into the skill metadata the lattice write and asset store operations accept. Import parses one SKILL.md and writes it to <skillset>/<name> in one step, so the body never passes through a model. Skills are ordinary assets: edit and remove them with the lattice operations.

Name:skills
Class:covia.adapter.SkillsAdapter

MCP Tools

This adapter provides 4 MCP tool(s) for AI agent integration:

Tool NameDescription
skills_readReads one skill in full without loading it: its instructions, the operations it contributes, and the further skills and skillsets it makes discoverable. Takes a resolved path or asset ref — find one with the skill-list operation, since a skill name is only meaningful against declared sources. Read-only; author skills with the lattice write and asset store operations.
skills_listLists the skills in a skillset — a directory whose entries are skills. Returns a map from each skill's resolved path to its index information, so a caller sees where a skill lives next to what it is; read one in full with the skill-read operation. Entries that are not skills (nested directories, unrelated data) are omitted. Omit 'skillset' to list this venue's configured entry skillsets (see v/info/adapters/skills). Read-only.
skills_parseTranslates 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.
skills_importImports one SKILL.md (Anthropic Agent Skills format) as a Covia skill: parses it exactly as the skill-parse operation does and writes the resulting metadata to <skillset>/<name>, where the name comes from the frontmatter and the skillset defaults to w/skills — the personal skills directory every standard agent template indexes first. One source per call, always a single SKILL.md, never a directory: name each file you want. The body never passes through the model. Re-importing the same skill overwrites its entry. By default the body is copied into the venue; choose content 'ref' to keep it bound live to the source file so edits on disk show on the next turn (the index line is a snapshot — re-import to refresh it).

Navigation

Back to all adapters

Back to index