skills/express-insight/SKILL.md
Communicate an integrated insight in a way that is accessible, actionable, and preserves the multi-domain nature of the understanding. Integrated insights are multi-dimensional — linearizing them risks losing the relationships that make them valuable. This skill provides a structured procedure for choosing the right form, expressing the gestalt with honest attribution, and inviting productive challenge. Use after integrate-gestalt has formed a cross-domain understanding that needs to be communicated to an audience — domain specialists, generalists, or decision-makers.
npx skillsauth add pjt222/agent-almanac express-insightInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Communicate a multi-domain gestalt so that it lands — preserving the relationships between domains, making the synthesis accessible to the audience, and being honest about where the integration simplifies or risks distortion. Expression is the final step of the synoptic cycle: without it, integrated understanding remains private and unactionable. The challenge is that language is linear but insights are not — this skill provides structures for communicating multi-dimensional understanding without reducing it to a single dimension.
integrate-gestalt has produced a cross-domain understanding that needs to be communicatedintegrate-gestalt or equivalent cross-domain synthesis)Determine who receives this insight and what they need from it. The same gestalt expressed to three different audiences should take three different forms.
Expected: A clear picture of who the audience is, what they need, and what will make the insight credible to them. The audience assessment should influence every subsequent step.
On failure: If the audience is unknown or too broad to characterize, default to the mixed-audience approach: big picture first, domain depth on demand. Communicating to "everyone" is less effective than communicating to someone specific, but it is better than guessing wrong.
Select the expression format that best serves the audience and the nature of the insight. Form is not decoration — it determines what the audience can perceive.
Evaluate the four primary forms:
| Form | Structure | Best for | |------|-----------|----------| | Narrative | Story connecting domains — "when X happens in domain A, it creates Y in domain B, which means Z" | Complex or novel insights where the audience needs to follow the reasoning path | | Diagram | Spatial layout showing relationships — nodes are domain contributions, edges are connections | Structural insights where the topology of relationships matters more than the sequence | | Comparison table | Each domain's perspective on the same issue in parallel columns | Analytical audiences who want to verify each domain's contribution independently | | Recommendation | Actionable synthesis — "do X because domains A, B, and C converge on Y, with trade-off Z" | Decision-makers who need to act, not just understand |
Match form to insight type:
Consider combining forms: a recommendation backed by a comparison table, or a narrative illustrated with a diagram. But lead with one primary form — cognitive load from multiple formats can obscure rather than clarify
Account for medium constraints: a verbal summary cannot carry a comparison table; a commit message cannot carry a narrative. If the medium constrains form, adjust the form rather than forcing content into an incompatible container
Expected: A chosen primary form (and optional secondary form) with a clear rationale tied to the audience and the nature of the insight.
On failure: If no form feels right, the insight may not yet be fully integrated. Return to integrate-gestalt — difficulty expressing often signals incomplete synthesis, not a communication problem.
Communicate the insight in the chosen form, explicitly noting what it integrates, where it simplifies, and what it enables.
Expected: A communicated insight that the audience can understand, verify against their own expertise, and act on. The simplifications are visible, not hidden. The emergent value is clear.
On failure: If the expression feels like a list of domain contributions rather than an integrated whole, the gestalt has been decomposed during communication. Step back and re-express: start from what the combination reveals, not from what each domain says separately. The synthesis is the message, not the parts.
State the strongest reason the insight might be wrong. Integrated insights can feel more certain than they are because they synthesize many inputs — convergence creates a sense of validity that may be unearned. This step is not a disclaimer appended for politeness; it is a structural component that makes the insight usable.
Expected: An honest statement of uncertainty that increases rather than decreases the audience's trust. The insight is now challengeable — and therefore improvable.
On failure: If no weakness can be identified, that itself is a warning sign. All cross-domain insights involve translation between frameworks, and translation always loses something. If the loss is invisible, it has not been found yet, not avoided. Look harder at the domain boundaries — that is where hidden assumptions live. Common hiding places: shared metaphors that work differently in each domain, statistical correlations assumed to be causal across domain boundaries, and analogies that hold structurally but not quantitatively.
integrate-gestalt, not hereintegrate-gestalt — produces the insight that this skill expresses; express-insight is the communication phase of the synoptic cycleargumentation — builds a logical case for a claim; express-insight communicates a perception. Argumentation says "here is why X is true"; express-insight says "here is what becomes visible when you look at A, B, and C together"teach — transfers known, established knowledge; express-insight conveys emergent understanding just formed. Teaching transmits; expressing revealsshine — channels authentic presence into communication; express-insight can use that radiance to carry multi-domain perception without losing warmth or honestyexpand-awareness — widens the perceptual field that makes integration possible; express-insight closes the cycle by communicating what that widened field revealedadaptic — the meta-skill composing the full synoptic cycle; express-insight is the fifth and final step in the clear-open-perceive-integrate-express sequencetesting
Launch all available agents in parallel waves for open-ended hypothesis generation on problems where the correct domain is unknown. Use when facing a cross-domain problem with no clear starting point, when single-agent approaches have stalled, or when diverse perspectives are more valuable than deep expertise. Produces a ranked hypothesis set with convergence analysis and adversarial refinement.
tools
Write integration tests for a Node.js CLI application using the built-in node:test module. Covers the exec helper pattern, output assertions, filesystem state verification, cleanup hooks, JSON output parsing, error case testing, and state restoration after destructive tests. Use when adding tests to an existing CLI, testing a new command, verifying adapter behavior across frameworks, or setting up CI for a CLI tool.
development
Screen a proposed trademark for conflicts and distinctiveness before filing. Covers trademark database searches (TMview, WIPO Global Brand Database, USPTO TESS), distinctiveness analysis using the Abercrombie spectrum, likelihood of confusion assessment using DuPont factors and EUIPO relative grounds, common law rights evaluation, and goods/services overlap analysis. Produces a conflict report with a risk matrix. Use before adopting a new brand name, logo, or slogan — distinct from patent prior art search, which uses different databases, legal frameworks, and analysis methods.
tools
Scaffold a new CLI command using Commander.js with options, action handler, three output modes (human-readable, quiet, JSON), and optional ceremony variant. Covers command naming, option design, shared context patterns, error handling, and integration testing. Use when adding a command to an existing Commander.js CLI, designing a new CLI tool from scratch, or standardizing command structure across a multi-command CLI.