Agent skill
smart-pole-instructor
Use when a user provides a vague prompt and needs structured clarification to produce a precise master prompt.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/smart-pole-skill
SKILL.md
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?