smart-pole-instructor
cuongpt083/smart-pole-skillUse when a user provides a vague prompt and needs structured clarification to produce a precise master prompt.
24 stars
13 forks
30 views
SKILL.md
name: smart-pole-instructor description: Use when a user provides a vague prompt and needs structured clarification to produce a precise master prompt.
SMART POLE Instructor Skill
This Skill implements the SMART POLE framework for prompt engineering. It acts as an instructor that identifies missing context (SP-flaws) and suggests specific details (SP-atoms) to create a Master Prompt.
How to use this Skill
- Invoke the Skill: Start a conversation by saying you want to improve a prompt.
- Provide your Prompt: Paste the vague or draft prompt you have.
- Receive Analysis: The Skill will list the SP-flaws (missing categories). (Note: Models like Claude will use
<thinking>tags for this). - Iterate: Answer the questions or add the atoms suggested.
- Get the Master Prompt: Use the generated Master Prompt for your final task.
The 9 Categories
| Abbrev | Category | Focus | Priority |
|---|---|---|---|
| S | Style | Tone, Persona, Format | 🟢 Accelerator |
| M | Mastery | Expertise level | 🟡 Contextualizer |
| A | Aim | Goal and Success criteria | 🔴 CORE |
| R | Resource | Tools, Constraints, Budget | 🟡 Contextualizer |
| T | Time | Era, Deadlines, Duration | 🟢 Accelerator |
| P | People | Audience, Values, Preferences | 🟡 Contextualizer |
| O | Outline | Structure, Scope | 🔴 CORE |
| L | Locale | Industry, Region, Legal, Cultural | 🔴/🟡 CONDITIONAL |
| E | Example | Samples, Reference styles | 🟢 Accelerator |
Locale Sub-dimensions (L1-L4)
- L1: Industry/Domain (Banking, Healthcare, E-commerce...)
- L2: Geography/Region (Vietnam, EU, Singapore...)
- L3: Legal/Regulatory (GDPR, PCI-DSS...)
- L4: Cultural/Social (Local customs, social norms...)
Task-Type Classification (NEW)
Locale becomes CORE for consulting/brainstorm tasks:
| Task Type | Locale | When to use |
|---|---|---|
| Deterministic | Optional | Math, algorithms, bug fixes |
| Generative | Contextual | Writing, designing |
| Advisory/Discovery | CORE | Consulting, brainstorming, strategy |
Example Interaction
User: "Help me write a diet plan."
Instructor: "Whoa there! That's a classic 'Vague Blob' of a prompt. Let's fix those SP-flaws:
- Category (R): What food do you have? Are you vegan?
- Category (A): Is the goal to lose weight or build muscle?
- Category (T): Is this for a week or a lifetime?
Here are some SP-atoms to add..."
Optional: Workflow Integration
If you are building an automated workflow, consider using the SMART POLE Enforcer skill instead, which provides structured XML output.