Skip to content

Skills are procedures as data, discovered and checked, never registered

A skill is one directory under the layer; adding it is the whole act, and the command line, the website and MCP all read it from the same file.

status
feature status: stable
domain
Context

What it does

majordomus skills list shows every skill the source class discovered, skills show one of them, skills check every one against its contract; the website's skills section and the MCP resources are projections of the same files.

What it does not do

A skill that merely describes is documentation and belongs in the docs. Nothing ranks skills and nothing loads one by default.

How it works

The capability modules of the executable this feature names, each with the capabilities it composes. The interfaces each one reaches are listed under Interfaces below: they are projections of one declaration, not separate registrations.

Skills skills behaviorally verified

Every skill the layer defines as a proven capability: whether a test names it and the evidence ledger holds a current passing run of that test, whether the site projects its page, whether a doctrine and a CI gate hold it, and whether a workflow, prompt, profile, provider template, recipe or CI workflow invokes it. All four are derived on every read and none is authored; an active skill no test names or nothing invokes is an orphan.

The objects it is made of

Kinds of the layer. Each is a schema, a source class and a file on disk; the number beside it is what this repository holds today, counted at build time.

  • skill8

Where it sits

domain
Context — Every worker starts from what the repository already knows: the context that applies to its path, the handover the last session left, and the decisions already made.
areas of work
documentation

Interfaces

Each capability behind it, on every interface it is projected onto. A link goes to this site's reference for that interface; an HTTP route and an MCP tool are answered by a running majordomus serve, not by this site.

The capabilities behind this feature, by interface
capabilitycommand lineHTTPMCP tool
skills.explain majordomus skills explain GET /api/v1/skills/explain majordomus_skill_explain
skills.status majordomus skills status GET /api/v1/skills majordomus_skills
skills.verify majordomus skills verify GET /api/v1/skills/verify majordomus_skills_verify

Evidence

What is guaranteed

Each claim this feature names, with the status its row declares, the verdict the recorded runs support, and the test that settles it.

Executable use cases

The rules that hold it

The decisions behind it

Using it

The commands that run it

  • majordomus skills work · read-only

    The repository's skills — provider-neutral procedures under the skills section — listed, shown and checked from the one catalogue every surface reads.

From the executable's command line

The synopsis of each, as the executable's own help prints it.

Where this page comes from

the file
.ai/repo/features/skills.md
the same answer
majordomus product show skills
read further

Concepts

Searches the titles and descriptions of every page this site publishes.