feat(crit): rewrite skill to implement CRIT framework (#6)
This PR rewrites the `crit` skill from a general description into a concrete CRIT (Context-Request-Input-Tone) workflow. ## Changes - Transformed abstract skill description into structured 5-step workflow - Added clear completion criteria for each step - Implemented quality guardrails and trigger hints - Followed established patterns from other skills (conversation-summary, knowledge-gardener) ## Impact - Makes the crit skill more actionable and predictable - Provides systematic brainstorming and idea evaluation - Improves user experience with structured guidance ## Files Changed - common/pkm/crit/SKILL.md Co-authored-by: Steve Beaulac <steve@beaulac.me> Reviewed-on: steve/Skills#6
This commit was merged in pull request #6.
This commit is contained in:
+105
-38
@@ -4,49 +4,116 @@ description: brainstorm with AI using the CRIT framework to generate and evaluat
|
|||||||
disable-model-invocation: true
|
disable-model-invocation: true
|
||||||
---
|
---
|
||||||
|
|
||||||
### Goal
|
## Purpose
|
||||||
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
|
This skill implements the CRIT (Context-Request-Input-Tone) framework for structured brainstorming and idea evaluation. It transforms abstract discussions into concrete, actionable outcomes through systematic analysis and iterative refinement.
|
||||||
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
|
## Core Workflow
|
||||||
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
|
### Step 1: Context Analysis
|
||||||
Before providing solutions:
|
Before generating ideas, establish the foundation:
|
||||||
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:
|
1. **Identify the Core Domain**
|
||||||
- “Could you share more details about your goal?”
|
- What field, industry, or subject area?
|
||||||
- “Are there any constraints I should consider?”
|
- What are the key constraints (time, resources, technical limitations)?
|
||||||
- “What’s your experience level with this topic?”
|
- Who is the target audience and their expertise level?
|
||||||
|
|
||||||
### Response Framework
|
2. **Assess Current State**
|
||||||
When delivering answers:
|
- What problems or opportunities exist?
|
||||||
1. Provide **clear, actionable solutions**
|
- What has been tried before (if applicable)?
|
||||||
2. Organize information **logically and concisely**
|
- What resources are available?
|
||||||
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
|
**Completion Criterion**: Clear understanding of domain, constraints, and current state documented.
|
||||||
- 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.
|
### Step 2: Request Clarification
|
||||||
|
Structure the brainstorming request:
|
||||||
|
|
||||||
|
1. **Define the Specific Goal**
|
||||||
|
- What concrete outcome do you want?
|
||||||
|
- What success criteria will be used?
|
||||||
|
- What is the expected timeline?
|
||||||
|
|
||||||
|
2. **Gather Input Requirements**
|
||||||
|
- What information is needed to proceed?
|
||||||
|
- What assumptions should be validated?
|
||||||
|
- What data or resources are required?
|
||||||
|
|
||||||
|
**Completion Criterion**: Specific goal and input requirements clearly defined.
|
||||||
|
|
||||||
|
### Step 3: Idea Generation
|
||||||
|
Generate diverse, high-quality ideas:
|
||||||
|
|
||||||
|
1. **Divergent Thinking Phase**
|
||||||
|
- Generate 5-10 initial concepts without judgment
|
||||||
|
- Apply different perspectives (technical, business, user experience)
|
||||||
|
- Include both obvious and unconventional options
|
||||||
|
|
||||||
|
2. **Convergent Analysis Phase**
|
||||||
|
- Evaluate each idea against success criteria
|
||||||
|
- Score ideas on feasibility, impact, and alignment
|
||||||
|
- Identify patterns and synergies between ideas
|
||||||
|
|
||||||
|
**Completion Criterion**: Minimum 5 distinct ideas generated and evaluated with scores.
|
||||||
|
|
||||||
|
### Step 4: Iterative Refinement
|
||||||
|
Improve selected ideas:
|
||||||
|
|
||||||
|
1. **Select Top Candidates**
|
||||||
|
- Choose 2-3 ideas with highest potential
|
||||||
|
- Detail implementation approach for each
|
||||||
|
- Identify risks and mitigation strategies
|
||||||
|
|
||||||
|
2. **Develop Action Plans**
|
||||||
|
- Break down into concrete steps
|
||||||
|
- Assign priorities and dependencies
|
||||||
|
- Define success metrics and checkpoints
|
||||||
|
|
||||||
|
**Completion Criterion**: 2-3 refined ideas with detailed action plans.
|
||||||
|
|
||||||
|
### Step 5: Tone & Delivery
|
||||||
|
Adapt communication to the audience:
|
||||||
|
|
||||||
|
1. **Choose Appropriate Role**
|
||||||
|
- Subject Matter Expert for technical depth
|
||||||
|
- Consultant for strategic guidance
|
||||||
|
- Teacher for complex concepts
|
||||||
|
- Collaborator for co-creation
|
||||||
|
- Analyst for multi-perspective evaluation
|
||||||
|
|
||||||
|
2. **Structure Response**
|
||||||
|
- Lead with clear, actionable solutions
|
||||||
|
- Organize information logically and concisely
|
||||||
|
- Include examples or analogies for clarity
|
||||||
|
- Suggest next steps and follow-up questions
|
||||||
|
|
||||||
|
**Completion Criterion**: Response delivered in appropriate tone with clear structure.
|
||||||
|
|
||||||
|
## Quality Guardrails
|
||||||
|
|
||||||
|
- Never generate ideas without clear context and goals
|
||||||
|
- Always evaluate ideas against defined success criteria
|
||||||
|
- Maintain transparency about assumptions and limitations
|
||||||
|
- Encourage iteration and collaboration throughout the process
|
||||||
|
- Ensure all recommendations are practical and actionable
|
||||||
|
|
||||||
|
## Trigger Hints
|
||||||
|
|
||||||
|
Load this skill when the user asks to:
|
||||||
|
- Generate ideas for a specific problem or opportunity
|
||||||
|
- Brainstorm solutions with structured evaluation
|
||||||
|
- Get expert guidance through systematic analysis
|
||||||
|
- Develop actionable plans from abstract concepts
|
||||||
|
- Evaluate multiple approaches to a challenge
|
||||||
|
|
||||||
|
## Output Format
|
||||||
|
|
||||||
|
Return results in this structure:
|
||||||
|
|
||||||
|
1. **Context Analysis**: Documented understanding of domain and constraints
|
||||||
|
2. **Request Clarification**: Defined goals and input requirements
|
||||||
|
3. **Idea Generation**: List of ideas with evaluation scores
|
||||||
|
4. **Refined Solutions**: Detailed action plans for top candidates
|
||||||
|
5. **Next Steps**: Suggested follow-up actions and questions
|
||||||
|
|
||||||
|
Each section should be clearly labeled and include completion criteria verification.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user