FAQ

What is "Skillerr"?

"Skillerr" names the reference CLI package (npm i -g skillerr), not the project. The project is the Open .skill Protocol — an open specification and portable .skill format so AI apps and agents can author, inspect, version, and run skills interoperably. Full breakdown of every name involved (protocol, format, npm scope, CLI, wire identifiers): Naming. Site: skillerr.com.

What is the Open .skill Protocol?

An open specification for portable AI skills: a sealed .skill package with typed inputs, workflow, pinned knowledge, redacted journey provenance, integrity digests, and optional mint attestation. Conforming hosts adopt the same create / ingest / trust / run lifecycle.

What is the skillerr package?

skillerr is the reference implementation CLI (bin: skill) — one conforming surface for create, inspect, and run. The protocol is not limited to this package; hosts may integrate the @skillerr/* protocol libraries or ship an independent conforming port.

How do I use it?

Install once, then talk to your AI — paste a prompt that points the agent at create, inspect, load, or handoff. You review and approve releases.

npm i -g skillerr

See Getting started.

Why would an app implement the protocol?

So skills are interoperable: one artifact moves between tools with inspectable digests, TrustView before execute, continuity handoffs, and release completeness gates — instead of proprietary chat dumps or free-form markdown alone.

How is this different from SKILL.md?

Structured package + digests + mint + continuity handoff + release compile gates. Markdown is a lossy adapter only (skill to-skill-md).

Continuity vs release?

• Continuity — work handoff between agents or hosts (partial OK, not mintable).
• Release — complete reusable skill or compile_refused.

Who creates skills?

Agents create (declared host required). Humans install once, prompt the agent, review and approve release compilation. Declared host/model provenance is self-reported unless a verified issuer is configured.

Can I set SKILL_HOST=human?

No. Denylisted hosts (human, cli, shell, manual, …) cannot mint. Do not fake a human host.

How do I create a skill?

Ask your agent (see Getting started). The agent sets SKILL_HOST and runs init → propose → checkpoint or compile --approve --mint. Prefer exact human-approved section bodies. See Create a skill and Agents.

How do I ingest or run a skill?

Ask your agent to inspect first, then validate, then dry-run. See Ingest a skill.

Where do I publish?

Share the .skill file directly. Optional local transparency log: skill registry …. Hosted registries are out of scope for the protocol.

Do I need a blockchain?

No. Optional ledger anchors may appear later as one permanence kind — never required.

Is this ready to use?

Yes, for real use today — digests, validation, inspect-before-run, and the runtime capability gate are all real, tested code. The protocol spec is versioned Draft 0.5.0 and evolves in the open via RFCs as more hosts adopt it — a normal spec-maturity stage, not a claim that the tooling is unreliable.

For production trust, configure a real Ed25519 issuer key (skill keygen + --signer-key) so mints earn verified_issuer trust — the bundled zero-setup key is for trying the CLI, not for shipping. A configured key alone isn't enough, though: verified_issuer also requires real agent-runtime evidence (a session id or runtime markers), or the mint fails loudly with a clear error rather than silently downgrading. See the OSS repo's Key ceremony for the full generate → mint → pin walkthrough, and What is verifiable for exactly what a signature proves either way.

Do local / offline agents work?

Yes. Ask your agent to set SKILL_HOST / provider / model / deployment for Ollama, LM Studio, llama.cpp, and similar. Runtime dry-run stays local; model invocation in execute mode needs a host adapter.

What does unsigned mean?

Untrusted. Execute refuses unless the host explicitly allows untrusted run.

Can a seal prove which local model wrote the skill?

No. A seal proves which key signed which claims. Local LLMs can still misreport authorship. See Trust and security.

Claude Desktop claims .skill on macOS — is that Skillerr?

No. On macOS, Claude Desktop may register the .skill extension for its own Agent Skills format (a zip with SKILL.md inside). Skillerr .skill files are a different sealed package (typed contract, digests, mint, assets) — same extension, different format.

What to do: Use the CLI (skill inspect ./file.skill) or your AI agent to identify the file. In Finder, use Open With → your editor or terminal instead of double-clicking if the wrong app opens. Do not assume every .skill file is Claude-native or Skillerr-native without inspecting.