maestro-knowhow

Capture natural-language knowhow entries into a persistent project knowledge store.

76|5|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/catlog22/pi-maestro-flow --skill maestro-knowhow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro-knowhow
Source: https://github.com/catlog22/pi-maestro-flow/tree/main/.pi/skills/maestro-knowhow
Command: npx skills add https://github.com/catlog22/pi-maestro-flow --skill maestro-knowhow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly record reusable knowhow without deciding the format up front, turning a vague capture intent into a structured knowledge entry.

Core Features & Use Cases

  • Intent-driven capture: Accepts natural requests like a decision, template, recipe, tip, or reference and infers the right entry type.
  • Knowledge precipitation: Writes captured knowhow into .workflow/knowhow/ for later reuse across sessions.
  • Practical use cases: Save an ADR for an architecture choice, preserve a retry-code template, or store a debugging tip for future reference.

Quick Start

Tell the assistant to capture a knowhow note about your chosen decision, template, recipe, tip, or reference in this project.

Frequently Asked Questions about maestro-knowhow

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

FAQPage Schema
How do I capture reusable decisions and tips from natural language text?

To capture reusable decisions and tips, you provide a natural-language intent and the system infers the entry type, writing structured knowhow directly into `.workflow/knowhow/`. This eliminates the need to manually decide the format up front.

What is the best way to save an architecture decision record for future sessions?

Saving an architecture decision record is best handled by inferring the entry type from your request and storing it as a structured knowledge entry in `.workflow/knowhow/`. This ensures the decision is persisted for later reuse across sessions.

Can I store debugging recipes and templates without defining a format beforehand?

Yes, you can store debugging recipes and templates without defining a format beforehand. The intent-driven capture mechanism accepts natural requests and automatically pins the correct type by keywords before writing to the knowledge store.

How does keyword inference work when saving a reference or session summary?

Keyword inference works by analyzing your natural-language intent to automatically pin the entry type, such as a reference or session summary. It then captures the knowhow into a persistent project store without requiring explicit format selection.

What types of knowhow entries can I record in a project knowledge base?

You can record decision records, templates, recipes, references, tips, and session summaries in a project knowledge base. The system processes natural-language intent to determine the appropriate type and stores the entry for reuse.

Do I need write access to capture session summaries and project references?

Yes, you need write access to the knowledge capture workflow directory to capture session summaries and project references. This access allows the system to persist entries directly into `.workflow/knowhow/` for future retrieval.