maestro-knowhow

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

76|5|Updated Jul 7, 2026

Search Tags:#template #knowledge base #reference #decision #capture #knowhow

Ready to run

npx skills add https://github.com/catlog22/pi-maestro-flow --skill maestro-knowhow

💬 Prompt for ChatGPT / Claude Chat▼

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.