aiskillstore/marketplace / skills/aaronabuusama/prompting
prompting
VerifiedPrompt engineering standards and context engineering principles for AI agents based on Anthropic best practices. Covers clarity, structure, progressive discovery, and optimization for signal-to-noise ratio.
Prompting Skill
When to Activate This Skill
- Prompt engineering questions
- Context engineering guidance
- AI agent design
- Prompt structure help
- Best practices for LLM prompts
- Agent configuration
Core Philosophy
Context engineering = Curating optimal set of tokens during LLM inference
Primary Goal: Find smallest possible set of high-signal tokens that maximize desired outcomes
Key Principles
1. Context is Finite Resource
- LLMs have limited "attention budget"
- Performance degrades as context grows
- Every token depletes capacity
- Treat context as precious
2. Optimize Signal-to-Noise
- Clear, direct language over verbose explanations
- Remove redundant information
- Focus on high-value tokens
3. Progressive Discovery
- Use lightweight identifiers vs full data dumps
- Load detailed info dynamically when needed
- Just-in-time information loading
Markdown Structure Standards
Use clear semantic sections:
- Background Information: Minimal essential context
- Instructions: Imperative voice, specific, actionable
- Examples: Show don't tell, concise, representative
- Constraints: Boundaries, limitations, success criteria
Writing Style
Clarity Over Completeness
✅ Good: "Validate input before processing" ❌ Bad: "You should always make sure to validate..."
Be Direct
✅ Good: "Use calculate_tax tool with amount and jurisdiction" ❌ Bad: "You might want to consider using..."
Use Structured Lists
✅ Good: Bulleted constraints ❌ Bad: Paragraph of requirements
Context Management
Just-in-Time Loading
Don't load full data dumps - use references and load when needed
Structured Note-Taking
Persist important info outside context window
Sub-Agent Architecture
Delegate subtasks to specialized agents with minimal context
Best Practices Checklist
- Uses Markdown headers for organization
- Clear, direct, minimal language
- No redundant information
- Actionable instructions
- Concrete examples
- Clear constraints
- Just-in-time loading when appropriate
Anti-Patterns
❌ Verbose explanations ❌ Historical context dumping ❌ Overlapping tool definitions ❌ Premature information loading ❌ Vague instructions ("might", "could", "should")
Supplementary Resources
For full standards: read ${PAI_DIR}/skills/prompting/CLAUDE.md
Based On
Anthropic's "Effective Context Engineering for AI Agents"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |