Agent skill
negative-contrastive-framing
Use when clarifying fuzzy boundaries, defining quality criteria, teaching by counterexample, preventing common mistakes, setting design guardrails, disambiguating similar concepts, refining requirements through anti-patterns, creating clear decision criteria, or when user mentions near-miss examples, anti-goals, what not to do, negative examples, counterexamples, or boundary clarification.
Install this agent skill to your Project
npx add-skill https://github.com/lyndonkl/claude/tree/main/skills/negative-contrastive-framing
SKILL.md
Negative Contrastive Framing
Table of Contents
- Purpose
- When to Use
- What Is It
- Workflow
- Common Patterns
- Guardrails
- Quick Reference
Purpose
Define concepts, quality criteria, and boundaries by showing what they're NOT—using anti-goals, near-miss examples, and failure patterns to create crisp decision criteria where positive definitions alone are ambiguous.
When to Use
Clarifying Fuzzy Boundaries:
- Positive definition exists but edges are unclear
- Multiple interpretations cause confusion
- Team debates what "counts" as meeting criteria
- Need to distinguish similar concepts
Teaching & Communication:
- Explaining concepts to learners who need counterexamples
- Training teams to recognize anti-patterns
- Creating style guides with do's and don'ts
- Onboarding with common mistake prevention
Setting Standards:
- Defining code quality (show bad patterns)
- Establishing design principles (show violations)
- Creating evaluation rubrics (clarify failure modes)
- Building decision criteria (identify disqualifiers)
Preventing Errors:
- Near-miss incidents revealing risk patterns
- Common mistakes that need explicit guards
- Edge cases that almost pass but shouldn't
- Subtle failures that look like successes
What Is It
Negative contrastive framing defines something by showing what it's NOT:
Types of Negative Examples:
- Anti-goals: Opposite of desired outcome ("not slow" → define fast)
- Near-misses: Examples that almost qualify but fail on key dimension
- Failure patterns: Common mistakes that violate criteria
- Boundary cases: Edge examples clarifying where line is drawn
Example: Defining "good UX":
- Positive: "Intuitive, efficient, delightful"
- Negative contrast:
- ❌ Near-miss: Fast but confusing (speed without clarity)
- ❌ Anti-pattern: Dark patterns (manipulative design)
- ❌ Failure: Requires manual to understand basic tasks
Workflow
Copy this checklist and track your progress:
Negative Contrastive Framing Progress:
- [ ] Step 1: Define positive concept
- [ ] Step 2: Identify negative examples
- [ ] Step 3: Analyze contrasts
- [ ] Step 4: Validate quality
- [ ] Step 5: Deliver framework
Step 1: Define positive concept
Start with initial positive definition, identify why it's ambiguous or fuzzy (multiple interpretations, edge cases unclear), and clarify purpose (teaching, decision-making, quality control). See Common Patterns for typical applications.
Step 2: Identify negative examples
For simple cases with clear anti-patterns → Use resources/template.md to structure anti-goals, near-misses, and failure patterns. For complex cases with subtle boundaries → Study resources/methodology.md for techniques like contrast matrices and boundary mapping.
Step 3: Analyze contrasts
Create negative-contrastive-framing.md with: positive definition, 3-5 anti-goals, 5-10 near-miss examples with explanations, common failure patterns, clear decision criteria ("passes if..." / "fails if..."), and boundary cases. Ensure contrasts reveal the why behind criteria.
Step 4: Validate quality
Self-assess using resources/evaluators/rubric_negative_contrastive_framing.json. Check: negative examples span the boundary space, near-misses are genuinely close calls, contrasts clarify criteria better than positive definition alone, failure patterns are actionable guards. Minimum standard: Average score ≥ 3.5.
Step 5: Deliver framework
Present completed framework with positive definition sharpened by negatives, most instructive near-misses highlighted, decision criteria operationalized as checklist, common mistakes identified for prevention.
Common Patterns
By Domain
Engineering (Code Quality):
- Positive: "Maintainable code"
- Negative: God objects, tight coupling, unclear names, magic numbers, exception swallowing
- Near-miss: Well-commented spaghetti code (documentation without structure)
Design (UX):
- Positive: "Intuitive interface"
- Negative: Hidden actions, inconsistent patterns, cryptic error messages
- Near-miss: Beautiful but unusable (form over function)
Communication (Clear Writing):
- Positive: "Clear documentation"
- Negative: Jargon-heavy, assuming context, no examples, passive voice
- Near-miss: Technically accurate but incomprehensible to target audience
Strategy (Market Positioning):
- Positive: "Premium brand"
- Negative: Overpriced without differentiation, luxury signaling without substance
- Near-miss: High price without service quality to match
By Application
Teaching:
- Show common mistakes students make
- Provide near-miss solutions revealing misconceptions
- Identify "looks right but is wrong" patterns
Decision Criteria:
- Define disqualifiers (automatic rejection criteria)
- Show edge cases that almost pass
- Clarify ambiguous middle ground
Quality Control:
- Identify anti-patterns to avoid
- Show subtle defects that might pass inspection
- Define clear pass/fail boundaries
Guardrails
Near-Miss Selection:
- Near-misses must be genuinely close to positive examples
- Should reveal specific dimension that fails (not globally bad)
- Avoid trivial failures—focus on subtle distinctions
Contrast Quality:
- Explain why each negative example fails
- Show what dimension violates criteria
- Make contrasts instructive, not just lists
Completeness:
- Cover failure modes across key dimensions
- Don't cherry-pick—include hard-to-classify cases
- Show spectrum from clear pass to clear fail
Actionability:
- Translate insights into decision rules
- Provide guards/checks to prevent failures
- Make criteria operationally testable
Avoid:
- Strawman negatives (unrealistically bad examples)
- Negatives without explanation (show what's wrong and why)
- Missing the "close call" zone (all examples clearly pass or fail)
Quick Reference
Resources:
resources/template.md- Structured format for anti-goals, near-misses, failure patternsresources/methodology.md- Advanced techniques (contrast matrices, boundary mapping, failure taxonomies)resources/evaluators/rubric_negative_contrastive_framing.json- Quality criteria
Output: negative-contrastive-framing.md with positive definition, anti-goals, near-misses with analysis, failure patterns, decision criteria
Success Criteria:
- Negative examples span boundary space (not just extremes)
- Near-misses are instructive close calls
- Contrasts clarify ambiguous criteria
- Failure patterns are actionable guards
- Decision criteria operationalized
- Score ≥ 3.5 on rubric
Quick Decisions:
- Clear anti-patterns? → Template only
- Subtle boundaries? → Use methodology for contrast matrices
- Teaching application? → Emphasize near-misses revealing misconceptions
- Quality control? → Focus on failure pattern taxonomy
Common Mistakes:
- Only showing extreme negatives (not instructive near-misses)
- Lists without analysis (not explaining why examples fail)
- Cherry-picking easy cases (avoiding hard boundary calls)
- Strawman negatives (unrealistically bad)
- No operationalization (criteria remain fuzzy despite contrasts)
Key Insight: Negative examples are most valuable when they're almost positive—close calls that force articulation of subtle criteria invisible in positive definition alone.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
synthesis-and-analogy
Use when synthesizing information from multiple sources (literature review, stakeholder feedback, research findings, data from different systems), creating or evaluating analogies for explanation or problem-solving (cross-domain transfer, "X is like Y", structural mapping), combining conflicting viewpoints into unified framework, identifying patterns across disparate sources, finding creative solutions by transferring principles from one domain to another, testing whether analogies hold (surface vs deep similarities), or when user mentions "synthesize", "combine sources", "analogy", "like", "similar to", "transfer from", "integrate findings", "what's it analogous to".
socratic-teaching-scaffolds
Use when teaching complex concepts (technical, scientific, philosophical), helping learners discover insights through guided questioning rather than direct explanation, correcting misconceptions by revealing contradictions, onboarding new team members through scaffolded learning, mentoring through problem-solving question frameworks, designing self-paced learning materials, or when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".
environmental-scanning-foresight
Use when scanning external trends for strategic planning, monitoring PESTLE forces (Political, Economic, Social, Technological, Legal, Environmental), detecting weak signals (early indicators of change), planning scenarios for multiple futures, setting signposts and indicators for early warning, or when user mentions environmental scanning, horizon scanning, trend analysis, scenario planning, strategic foresight, futures thinking, or emerging issues monitoring.
embedding-fusion-strategy
Use when designing embedding strategies that fuse semantic and structural information for knowledge graphs. Invoke when user mentions node embeddings, structural embeddings, semantic embeddings, contrastive alignment, embedding fusion, vector representations for graphs, or combining text and graph signals. Provides embedding selection, fusion design, and implementation guidance.
constraint-based-creativity
Use when brainstorming feels stuck or generates obvious ideas, need to break creative patterns, working with limited resources (budget/time/tools/materials), want unconventional solutions, designing with specific limitations, user mentions "think outside the box", "we're stuck", "same old ideas", "tight constraints", "limited budget/time", or seeking innovation through limitation rather than abundance.
symmetry-group-identifier
Use when you've identified candidate symmetries and need to map them to mathematical groups for architecture design. Invoke when user mentions cyclic groups, dihedral groups, Lie groups, SO(3), SE(3), permutation groups, or needs to formalize symmetries into group theory language. Provides taxonomy and mathematical foundations from Visual Group Theory principles.
Didn't find tool you were looking for?