smithery.ai

reverse-engineering-texts

Reverse-engineer texts into a reusable structural blueprint (reverse outlining, argument mining, copy teardown).

First seen Apr 20, 2026

Installation

$ npx skills add https://smithery.ai

Summary

  • Reverse-engineer texts into a reusable structural blueprint (reverse outlining, argument mining, copy teardown).
  • Use when the user asks to analyze a text’s thesis, hook, framework (AIDA/PAS/PASTOR/BAB), argument map, rhetoric (Ethos/Pathos/Logos), or when they want to convert “text → structure/blueprint” to reuse patterns in writing, specs, prompts, or marketing.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 10,938 B
  • docs SUMMARY.md 406 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Reverse-Engineering Texts

Goal

Turn a finished text into a TeardownBlueprint (a “drawing”) that is reusable: structure, argument moves, and rhetorical patterning.

Core disciplines (FPF-aligned)

  • Strict distinction: TextArtifact (the text) ≠ Blueprint (your description) ≠ Output (new draft/prompt).
  • Evidence first: Every non-trivial claim in the blueprint must include a short quote from the text (an “evidence anchor”).
  • Parsimony: Prefer the simplest structure/framework that explains the whole text.
  • Uncertainty: Mark low-confidence inferences explicitly.

What “SOTA” means here

This skill is not just “label AIDA and call it done”. State-of-the-art reverse-engineering requires:

  • Paradigm transparency: explicitly declare the interpretive lens used (and what would count as an “error” vs a paradigm clash).
  • Meaning-in-interaction: meaning is extracted in a dynamic local context, not “derived from rules given from above”.
  • Ambiguity handling: do not force-collapse; maintain multiple plausible interpretations when needed.
  • Order effects awareness: sometimes A→B ≠ B→A; record when the analysis is non-commutative.

Method layering

  • Core (default): fast, evidence-anchored teardown usable for most texts.
  • Advanced (SOTA extensions): modes, context-first grounding, ambiguity protocol, validation, non-commutativity, conflict taxonomy.

Quick workflow (text → blueprint)

0) Context-first (always)

  1. ContextCapture: Record what you know (or must assume): audience, intent, setting, speaker_role, genre, stakes.
  2. TermGrounding: Pick 5–10 key terms/entities in the text and define their meaning-in-context with quotes.
  3. ParadigmDeclaration: Declare the lens you will use (at minimum: descriptivestructural; optionally: pragmatic, hermeneutic, classicalepistemology, etc.). Also declare what counts as:

- intra-paradigm error (a contradiction/failure inside the chosen lens) - inter-paradigm conflict (a clash between lenses; not automatically an “error”)

1) Core teardown (default)

  1. Ingest: Copy the raw text verbatim as TextArtifact.
  2. Segment: Split into semantic blocks; name each block with a one-line intent.
  3. Spine: Infer the thesis and macro-structure (framework hypothesis).

- Also mark descriptivevsnormative: is the thesis describing reality, prescribing norms, or mixed?

  1. Hook: Classify the hook type + target emotion.
  2. Argument map: For each block, extract Claim + Support/Evidence type + relation to previous block.

- Also mark descriptivevsnormative per segment when relevant.

  1. Rhetoric: Map Ethos/Pathos/Logos and where each is used.
  2. Pattern extraction: Capture reusable micro-patterns (openings, transitions, proof moves).
  3. Reconstruct forward outline: Produce a forward scaffold (thesis → hook → outline → arguments).
  4. Audit: Ensure coverage + evidence anchors + note alternatives when ambiguous.

2) Advanced (SOTA extensions)

Use these when the situation calls for it. “Optional” here does NOT mean “skip”: each has triggers.

Modes (pick one; record in output)

  • ModeA_Immanent: analyze internal logic/structure only (no outside sources).
  • ModeB_Transcendent: validate/criticize using external sources (when available).
  • ModeC_Hybrid: run A then B (or B then A) and integrate.

Ambiguity protocol (conditional-mandatory)

  1. AmbiguityCheck (always): is there >=2 plausible interpretations of key elements (thesis/intent/referents/causality/value-laden terms)?
  2. If yes → ModeD_AmbiguityModel (mandatory):

- produce an interpretation_set (>=2 interpretations) - each interpretation must have evidence anchors (quotes) - provide “collapse conditions”: which context/goal/paradigm would prefer which interpretation - if you choose a single “best” interpretation, record why and what you lose

External validation (ModeB/ModeC)

  • Use >=3 independent sources when feasible; if not feasible, state constraints explicitly.
  • Output: agreements, disagreements, and how they affect the blueprint confidence.

Non-commutativity (when order might matter)

  • Run a lightweight A→B and B→A comparison on 1–2 key segments.
  • If results differ, record non_commutativity.detected: true and summarize the divergence (contextual priming / lens effects).

Conflict taxonomy (always when conflicts appear)

  • intra_paradigm: critical | significant | minor
  • inter_paradigm: paradigm conflict (not an error; requires boundary clarification)

Output contract

You MUST produce outputs in two phases:

Mandatory execution order (hard requirement)

  1. Read references/index.md (agent entrypoint)
  2. Select mode → references/mode-selection.md
  3. Read the matching template file (choose exactly one):

- references/teardownblueprint-v2-modeA-immanent.md - references/teardownblueprint-v2-modeB-transcendent.md - references/teardownblueprint-v2-modeC-hybrid.md

  1. Fill the template completely (do not invent new fields; keep schema)
  2. Check gates → references/quality-gates.md
  3. Only then (optionally) label frameworks → references/framework-markers.md
  4. Only if you need a pattern, read one concrete example file:

- references/modeA-mini.md - references/modeA-scientific-mini.md - references/modeC-philosophical-ambiguity.md

Template availability check (hard requirement)

Do NOT claim “templates are unavailable” unless you attempted to locate and read:

  • references/index.md
  • at least one concrete template file (the mode-matching one if possible):

- references/teardownblueprint-v2-modeA-immanent.md - references/teardownblueprint-v2-modeB-transcendent.md - references/teardownblueprint-v2-modeC-hybrid.md

Deliverables

Deliverable A (mandatory, always): TeardownBlueprint

Produce a TeardownBlueprint in the exact YAML shape of the matching template in references/ (one of the teardownblueprint-v2-*.md files).

Deliverable B (mandatory when user asks for a human-readable report/summary): HumanReadableReport

If the user asks for a “human-readable report/summary”, you MUST still output Deliverable A first, then derive Deliverable B strictly from the completed blueprint.

HumanReadableReport rules:

  • It is a reformulation of the blueprint, not a replacement for it.
  • Every major claim must be traceable to either:

- a quote inside TeardownBlueprint (thesis.evidence, segments[].evidence, rhetoric_summary., etc.), OR - an explicit “new inference” line marked confidence: low (and you must explain what is missing).

  • Do not add new requirements/claims that are absent from the blueprint unless explicitly marked as above.

Minimum QA checklist

  • Every major block is represented in segments.
  • Thesis and framework claims include quotes.
  • Each argument block has (claim, evidence_type, relation) + quote(s).
  • At least one reusable pattern is extracted.
  • Any guesswork is labeled with confidence: low and an alternative hypothesis is listed.

SOTA QA checklist (recommended)

  • context is captured (or assumptions are explicit).
  • term_grounding exists for key terms and is quote-backed.
  • paradigm and mode are explicit.
  • descriptivevsnormative is labeled for thesis (and segments when relevant).
  • AmbiguityCheck is present; if triggered, interpretation_set is present and quote-backed.
  • If external validation is claimed (ModeB/ModeC), sources and disagreement handling are documented.
  • If non-commutativity is claimed, the A→B vs B→A delta is recorded.

Acceptance criteria (definition of done)

Core acceptance (must pass)

  • Coverage: every semantic block in the text has a corresponding segments[*] entry.
  • Traceability: thesis/framework/each segment claim has >=1 quote.
  • Parsimony: framework label is the simplest that fits; otherwise other.
  • Uncertainty hygiene: any inferred-but-not-anchored statement is marked confidence: low and paired with an alternative hypothesis.

Dual-output compliance (must pass when user asks for report/summary)

  • Two-phase output: Deliverable A (TeardownBlueprint) is present and completed, and Deliverable B is derived from it.
  • Report mapping: each major section of the HumanReadableReport maps to one or more segments[*].id (explicitly or implicitly),

and no segment-level claim appears in the report without a corresponding segments[*] entry.

  • No-new-claims: the report introduces no new claims beyond the blueprint unless marked as confidence: low + missing evidence explained.

Advanced acceptance (when the feature is triggered/used)

  • Context-first: context is explicit; if not provided, assumptions are explicit and confidence is lowered.
  • Meaning grounding: term_grounding exists for key/value terms; no “dictionary-from-above” substitutions without quotes.
  • Ambiguity:

- ambiguity.check.detected=false OR - ambiguity.check.detected=true AND ambiguity.interpretationset has >=2 interpretations, each quote-backed, each with applieswhen.

  • Validation (ModeB/ModeC): include sources, and record how disagreements change confidence.
  • Non-commutativity (if tested): record both orders and a concrete delta summary.
  • Conflicts: classify as intra vs inter paradigm; do not “resolve” an inter-paradigm conflict as if it were an error.

Next actions (optional)

  • Generate a new draft from the blueprint (structure-first).
  • Build a personal PatternLibrary (swipe/teardown file) from repeated blueprints.

Additional resources

  • Agent entrypoint: [references/index.md](references/index.md)
  • Mode selection: [references/mode-selection.md](references/mode-selection.md)
  • Quality gates: [references/quality-gates.md](references/quality-gates.md)
  • Templates:

- references/teardownblueprint-v2-modeA-immanent.md - references/teardownblueprint-v2-modeB-transcendent.md - references/teardownblueprint-v2-modeC-hybrid.md

  • Examples:

- references/modeA-mini.md - references/modeA-scientific-mini.md - references/modeC-philosophical-ambiguity.md

  • Framework markers: [references/framework-markers.md](references/framework-markers.md)