livespec-help

Explains livespec capabilities and routes users to the correct livespec operation.

Updated Aug 15, 2026
One-click install
npx skills add https://github.com/thewoolleyman/livespec-driver-pi --skill livespec-help-thewoolleyman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: livespec-help
Source: https://github.com/thewoolleyman/livespec-driver-pi/tree/main/skills/livespec-help
Command: npx skills add https://github.com/thewoolleyman/livespec-driver-pi --skill livespec-help-thewoolleyman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users new to livespec often do not know which of its operations (seed, propose-change, critique, revise, doctor, prune-history, next) fits their current need. This Skill explains what livespec does and directs the user to the right operation without making any changes to the project. ## Core Features & Use Cases - Capability overview: Reads livespec core's harness-neutral help prose and presents what the framework can do in the pi runtime. - Operation routing: Maps the user's goal to one of the seven other livespec operations and points them to the matching /skill:livespec-<operation> binding. - Read-only guidance: Performs no mutations, making it safe to invoke for exploration at any time. - Use Case: A developer just installed livespec and the pi Driver and asks "what can livespec do for my project?" The Skill resolves the core root, reads the help prose, and recommends starting with the seed operation. ## Quick Start Ask the assistant what livespec can do and which operation to run first for your project.

Frequently Asked Questions about livespec-help

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find out what livespec can do?

Invoke the livespec-help skill in the pi runtime. It reads livespec core's help prose and presents an overview of all operations, then routes you to the operation matching your goal.

Which livespec operation should I run first?

The help operation explains each operation's purpose and recommends a starting point, typically seed for initializing a governed project. It presents options conversationally and waits for your choice since pi has no structured-picker tool.

Does livespec-help modify my project files?

No, livespec-help is read-only. It only resolves the livespec core root and reads the help prose, using bash and read tools without performing any mutating operations.

Why does livespec-help fail to resolve the core root?

Resolution fails when livespec core is not installed as a pi git package or when pi's project-trust gate silently ignores project packages in non-interactive runs. The resolver prints its own diagnostic to stderr, which should be surfaced verbatim.

Can I use livespec-help without installing livespec core?

No. The Driver package ships only the binding and resolver; the actual help prose lives in livespec core, which must be installed alongside as a resource-less pi git package.