From af96c9e33167081ca0b95aa726d2c4387d5794a7 Mon Sep 17 00:00:00 2001 From: Steve Beaulac Date: Mon, 22 Jun 2026 22:20:08 -0400 Subject: [PATCH] docs: reorganize skills into pkm category and add crit skill - Create new `pkm` directory for Personal Knowledge Management skills - Move conversation-summary, knowledge-gardener, and research-vault from `personal` to `pkm` - Add new crit skill for brainstorming with the CRIT framework - Update skill descriptions for clarity and consistency - Add audio-product-dsp, grilling, and research-engineering to model-invoked listings - Update skill paths across README files to reflect new directory structure --- README.md | 14 ++++- common/README.md | 19 ++++--- common/personal/README.md | 3 -- common/pkm/README.md | 12 +++++ .../conversation-summary/SKILL.md | 0 common/pkm/crit/SKILL.md | 52 +++++++++++++++++++ .../knowledge-gardener/SKILL.md | 0 .../{personal => pkm}/research-vault/SKILL.md | 0 .../references/research-packet-template.md | 0 9 files changed, 87 insertions(+), 13 deletions(-) create mode 100644 common/pkm/README.md rename common/{personal => pkm}/conversation-summary/SKILL.md (100%) create mode 100644 common/pkm/crit/SKILL.md rename common/{personal => pkm}/knowledge-gardener/SKILL.md (100%) rename common/{personal => pkm}/research-vault/SKILL.md (100%) rename common/{personal => pkm}/research-vault/references/research-packet-template.md (100%) diff --git a/README.md b/README.md index 619f428..e0df645 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,19 @@ A collection of agent skills (slash commands and behaviors) loaded into Steve Be ## User-invoked -- [pkm-curation](common/pkm-curation/SKILL.md) — Curate an Obsidian-style personal knowledge vault. +- [conversation-summary](common/pkm/conversation-summary/SKILL.md) — Summarize the current AI conversation into a new Obsidian markdown note and matching transcript file. +- [crit](common/pkm/crit/SKILL.md) — Brainstorm with AI using the CRIT framework to generate and evaluate ideas. +- [grill-me](common/productivity/grill-me/SKILL.md) — A relentless interview to sharpen a plan or design. +- [handoff](common/productivity/handoff/SKILL.md) — Compact the current conversation into a handoff document for another agent to pick up. +- [knowledge-gardener](common/pkm/knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows for this Obsidian vault. +- [pkm-curation](common/personal/pkm-curation/SKILL.md) — Curate an Obsidian-style personal knowledge vault. +- [research-vault](common/pkm/research-vault/SKILL.md) — Research a topic through a one-question-at-a-time learning conversation and save a linked Obsidian research packet. +- [writing-great-skills](common/productivity/writing-great-skills/SKILL.md) — Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable. ## Model-invoked -- [forge-preferences](common/personal/forge-preferences/SKILL.md) — Apply Steve's personal or project-specific GitHub/Gitea forge preferences. +- [audio-product-dsp](common/deprecated/audio-production-dispatcher/SKILL.md) — Dispatch audio product DSP hardware/software engineering requests to the best specialist workflow with measurable product-focused outputs. - [forge-interaction](common/engineering/forge-interaction/SKILL.md) — Work safely with GitHub and Gitea repositories, issues, pull requests, releases, and remote forge state. +- [forge-preferences](common/personal/forge-preferences/SKILL.md) — Apply Steve's personal or project-specific GitHub/Gitea forge preferences. +- [grilling](common/productivity/grilling/SKILL.md) — Interview the user relentlessly about a plan or design. +- [research-engineering](common/deprecated/dsp-research-dispatcher/SKILL.md) — Route DSP hardware and software research-engineering requests to the best specialist workflow and return a unified, decision-ready output. diff --git a/common/README.md b/common/README.md index 071d30e..e88ce9f 100644 --- a/common/README.md +++ b/common/README.md @@ -4,16 +4,19 @@ Skills that work in all CLI agents. ## User-invoked -- [conversation-summary](personal/conversation-summary/SKILL.md) — Create compact conversation summaries for continuity. -- [grill-me](productivity/grill-me/SKILL.md) — Run a terse adversarial critique. -- [grilling](productivity/grilling/SKILL.md) — Prepare grilling guidance. -- [handoff](productivity/handoff/SKILL.md) — Create a handoff note for continuing work. -- [knowledge-gardener](personal/knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows. +- [conversation-summary](pkm/conversation-summary/SKILL.md) — Summarize the current AI conversation into a new Obsidian markdown note and matching transcript file. +- [crit](pkm/crit/SKILL.md) — Brainstorm with AI using the CRIT framework to generate and evaluate ideas. +- [grill-me](productivity/grill-me/SKILL.md) — A relentless interview to sharpen a plan or design. +- [handoff](productivity/handoff/SKILL.md) — Compact the current conversation into a handoff document for another agent to pick up. +- [knowledge-gardener](pkm/knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows for this Obsidian vault. - [pkm-curation](personal/pkm-curation/SKILL.md) — Curate an Obsidian-style personal knowledge vault. -- [research-vault](personal/research-vault/SKILL.md) — Research a topic through a one-question-at-a-time conversation and store the packet in a new Obsidian vault folder with relevant links. -- [writing-great-skills](productivity/writing-great-skills/SKILL.md) — Reference for writing and editing predictable skills. +- [research-vault](pkm/research-vault/SKILL.md) — Research a topic through a one-question-at-a-time learning conversation and save a linked Obsidian research packet. +- [writing-great-skills](productivity/writing-great-skills/SKILL.md) — Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable. ## Model-invoked -- [forge-preferences](personal/forge-preferences/SKILL.md) — Apply Steve's personal or project-specific GitHub/Gitea forge preferences. +- [audio-product-dsp](deprecated/audio-production-dispatcher/SKILL.md) — Dispatch audio product DSP hardware/software engineering requests to the best specialist workflow with measurable product-focused outputs. - [forge-interaction](engineering/forge-interaction/SKILL.md) — Work safely with GitHub and Gitea repositories, issues, pull requests, releases, and remote forge state. +- [forge-preferences](personal/forge-preferences/SKILL.md) — Apply Steve's personal or project-specific GitHub/Gitea forge preferences. +- [grilling](productivity/grilling/SKILL.md) — Interview the user relentlessly about a plan or design. +- [research-engineering](deprecated/dsp-research-dispatcher/SKILL.md) — Route DSP hardware and software research-engineering requests to the best specialist workflow and return a unified, decision-ready output. diff --git a/common/personal/README.md b/common/personal/README.md index 51238c2..b39f26e 100644 --- a/common/personal/README.md +++ b/common/personal/README.md @@ -2,10 +2,7 @@ ## User-invoked -- [conversation-summary](conversation-summary/SKILL.md) — Create compact conversation summaries for continuity. -- [knowledge-gardener](knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows. - [pkm-curation](pkm-curation/SKILL.md) — Curate an Obsidian-style personal knowledge vault. -- [research-vault](research-vault/SKILL.md) — Research a topic through a one-question-at-a-time conversation and store the packet in a new Obsidian vault folder with relevant links. ## Model-invoked diff --git a/common/pkm/README.md b/common/pkm/README.md new file mode 100644 index 0000000..6aa0357 --- /dev/null +++ b/common/pkm/README.md @@ -0,0 +1,12 @@ +# PKM Skills + +## User-invoked + +- [conversation-summary](conversation-summary/SKILL.md) — Summarize the current AI conversation into a new Obsidian markdown note and matching transcript file. +- [crit](crit/SKILL.md) — Brainstorm with AI using the CRIT framework to generate and evaluate ideas. +- [knowledge-gardener](knowledge-gardener/SKILL.md) — Run vault-aware semantic search, synthesis, note creation, linking, and Zettelkasten workflows for this Obsidian vault. +- [research-vault](research-vault/SKILL.md) — Research a topic through a one-question-at-a-time learning conversation and save a linked Obsidian research packet. + +## Model-invoked + +_None yet._ diff --git a/common/personal/conversation-summary/SKILL.md b/common/pkm/conversation-summary/SKILL.md similarity index 100% rename from common/personal/conversation-summary/SKILL.md rename to common/pkm/conversation-summary/SKILL.md diff --git a/common/pkm/crit/SKILL.md b/common/pkm/crit/SKILL.md new file mode 100644 index 0000000..d20b6c4 --- /dev/null +++ b/common/pkm/crit/SKILL.md @@ -0,0 +1,52 @@ +--- +name: crit +description: brainstorm with AI using the CRIT framework to generate and evaluate ideas. +disable-model-invocation: true +--- + +### Goal +Act as an adaptive AI assistant that provides expert-level guidance across multiple domains. Your primary objective is to deliver accurate, practical, and context-aware solutions tailored to the user’s needs. + +### Context +Consider the following in every interaction: +- The user's skill level, background, and familiarity with the topic +- The complexity and scope of the request +- Any constraints (time, resources, technical limitations) +- The real-world application and implications of your advice + +### Roles +You can dynamically switch between these roles based on user needs: +- **Subject Matter Expert**: Provide deep technical or domain-specific knowledge +- **Consultant**: Offer strategic advice and actionable recommendations +- **Teacher**: Explain complex concepts in simple, clear terms +- **Collaborator**: Co-create solutions with the user +- **Analyst**: Evaluate problems from multiple perspectives and provide insights + +### Interaction Guidelines +Before providing solutions: +1. **Clarify the Request**: Ask targeted questions to confirm the user’s goal +2. **Identify Constraints**: Understand deadlines, limitations, or special requirements +3. **Assess Context**: Determine intended use case and experience level +4. **Define Scope**: Confirm whether the user needs a quick answer, detailed analysis, or ongoing support + +Sample clarifying questions: +- “Could you share more details about your goal?” +- “Are there any constraints I should consider?” +- “What’s your experience level with this topic?” + +### Response Framework +When delivering answers: +1. Provide **clear, actionable solutions** +2. Organize information **logically and concisely** +3. Offer **multiple approaches or perspectives** when relevant +4. Include **examples or analogies** for clarity +5. Suggest **next steps or follow-up questions** + +### Tone & Quality +- Be professional, approachable, and adaptive +- Ensure accuracy and transparency +- Acknowledge uncertainties when applicable +- Encourage iteration and collaboration + +**Key Principle**: Every interaction should feel like a meaningful, user-focused conversation that helps achieve their goals. + diff --git a/common/personal/knowledge-gardener/SKILL.md b/common/pkm/knowledge-gardener/SKILL.md similarity index 100% rename from common/personal/knowledge-gardener/SKILL.md rename to common/pkm/knowledge-gardener/SKILL.md diff --git a/common/personal/research-vault/SKILL.md b/common/pkm/research-vault/SKILL.md similarity index 100% rename from common/personal/research-vault/SKILL.md rename to common/pkm/research-vault/SKILL.md diff --git a/common/personal/research-vault/references/research-packet-template.md b/common/pkm/research-vault/references/research-packet-template.md similarity index 100% rename from common/personal/research-vault/references/research-packet-template.md rename to common/pkm/research-vault/references/research-packet-template.md