MCP HubMCP Hub
Вернуться к навыкам

express-insight

pjt222
Обновлено 2 days ago
8 просмотров
17
2
17
Посмотреть на GitHub
Метаai

О программе

Этот навык структурирует передачу сложных, междисциплинарных инсайтов, делая их доступными и применимыми на практике, без утраты их взаимосвязанной природы. Он предоставляет процедуру для выбора подходящего формата, представления целостного понимания с чёткой атрибуцией и приглашения к конструктивной обратной связи. Разработчикам следует использовать его после `integrate-gestalt` для эффективного обмена междисциплинарными результатами со специалистами, универсалами или лицами, принимающими решения.

Быстрая установка

Claude Code

Рекомендуется
Основной
npx skills add pjt222/agent-almanac -a claude-code
Команда плагинаАльтернативный
/plugin add https://github.com/pjt222/agent-almanac
Git клонированиеАльтернативный
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/express-insight

Скопируйте и вставьте эту команду в Claude Code для установки этого навыка

Документация

Express Insight

Say multi-domain gestalt so it lands — keep links between domains, make synthesis open to audience, be honest about where integration shrinks or risks distortion. Express is final step of synoptic cycle: without it, integrated understanding stays private and unactionable. Challenge is language is linear but insights are not — this skill gives shapes for talking multi-dimensional understanding without shrinking to single dimension.

When Use

  • After integrate-gestalt has made cross-domain understanding that needs to be said
  • When find spans many domains and single-domain frame would lose key links
  • When audience for insight differs from view that made it
  • When integrated understanding feels clear inside but resists plain talk
  • When pick depends on seeing how many domains touch, not just what each domain says alone
  • When prior tries to talk cross-domain find met with confusion or domain-specific pushback
  • When talking finds from synoptic-mind team session to stakeholders outside team

Inputs

  • Required: Integrated insight (output of integrate-gestalt or same cross-domain synthesis)
  • Required: Audience — who gets this insight (domain specialists, generalists, decision-makers, or mixed)
  • Optional: Limits on form (e.g., "must fit in PR description", "needs to be verbal summary")
  • Optional: Domains that were integrated (for clear credit)
  • Optional: Past failed tries to talk this insight (what did not land)

Steps

Step 1: Assess Audience

Figure who gets this insight and what they need from it. Same gestalt said to three different audiences should take three different forms.

  1. Spot main audience:
    • Domain specialists need their domain shown right — they will reject insight that oversimplifies their field, even if whole synthesis is right
    • Generalists need big picture — links between domains matter more than details inside any single one
    • Decision-makers need actionable implications with trade-offs — they want to know what to do, what it costs, what happens if they do nothing
    • Mixed audiences need layered talk: lead with big picture, then give domain-specific depth specialists can check
  2. Check audience existing mind-model:
    • What do they already know about each domain?
    • What links between domains will be new to them?
    • What assumptions might they hold that insight challenges?
  3. Spot trust need: how much backing does this audience need before they take cross-domain claim?
    • Specialists trust insight that respects their domain rigor
    • Generalists trust insight that makes complex stuff navigable without oversimplify
    • Decision-makers trust insight that honest shows trade-offs rather than hides them

Got: Clear picture of who audience is, what they need, what will make insight credible to them. Audience check should shape every later step.

If fail: Audience unknown or too broad to pin? Default to mixed-audience way: big picture first, domain depth on demand. Talking to "everyone" is less useful than talking to someone specific, but it is better than guessing wrong.

Step 2: Choose Form

Pick express format that best serves audience and nature of insight. Form is not decoration — it picks what audience can see.

  1. Check four main forms:

    FormStructureBest for
    NarrativeStory 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
    DiagramSpatial layout showing relationships — nodes are domain contributions, edges are connectionsStructural insights where the topology of relationships matters more than the sequence
    Comparison tableEach domain's perspective on the same issue in parallel columnsAnalytical audiences who want to verify each domain's contribution independently
    RecommendationActionable 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
  2. Match form to insight type:

    • Insight is about causal chain across domains? Use narrative
    • Insight is about structural links? Use diagram
    • Insight is about convergence or divergence between domains? Use comparison table
    • Insight is about what to do next? Use recommendation
  3. Think mix forms: recommendation backed by comparison table, or narrative shown with diagram. But lead with one main form — cognitive load from many formats can hide rather than clear

  4. Account for medium limits: verbal summary can't carry comparison table; commit msg can't carry narrative. If medium limits form, tune form rather than forcing content into wrong container

Got: Picked main form (and optional second form) with clear reason tied to audience and nature of insight.

If fail: No form feels right? Insight may not yet be fully integrated. Go back to integrate-gestalt — hard express often signals thin synthesis, not talk problem.

Step 3: Express the Gestalt

Say insight in picked form, clear note what it integrates, where it shrinks, and what it enables.

  1. State insight clear — one to three sentences that catch core understanding. This is gestalt itself, not backing evidence
  2. Name domains it integrates — clear list which domains fed this understanding. This is not credit for credit; it is credit for check. Each named domain is invite: "check this vs your expertise"
  3. Mark shrinks — every multi-domain insight shrinks. State where:
    • Which domain-specific nuances were set aside?
    • Which links treated as stronger or weaker than they might be?
    • What would specialist in domain X want to add or qualify?
  4. State emergent value — what does this insight enable that single-domain analysis does not?
    • What pick becomes possible that was not before?
    • What risk becomes visible that was hidden inside single domains?
    • What chance shows at the crossing that no single domain owns?
  5. Keep multi-domain texture — resist pull to flatten insight into one domain language. If insight integrates engineering and UX, use both vocabs. If it links research and ops, keep both framings. Texture is the insight
  6. Sequence for grasp — even though insight is non-linear, talk is sequential. Pick entry point that gives audience best foothold: start with domain they know best, then bridge out into unfamiliar domains. First sentence picks whether audience leans in or tunes out

Got: Said insight audience can grasp, check vs own expertise, and act on. Shrinks are visible, not hidden. Emergent value clear.

If fail: Express feels like list of domain contributions rather than integrated whole? Gestalt got broken during talk. Step back and re-express: start from what combination shows, not from what each domain says apart. Synthesis is message, not parts.

Step 4: Invite Challenge

State strongest reason insight might be wrong. Integrated insights can feel more certain than they are since they blend many inputs — convergence gives sense of validity that may be unearned. This step is not disclaimer slapped on for polite; it is structural part that makes insight usable.

  1. Spot weakest link — which domain link in insight is least well-backed? Where does integration lean on analogy rather than evidence?
  2. Name assumption at risk — what would need to be true for insight to hold, and how sure are you that it is true?
  3. State counter-insight — if someone with equal access to all same domains reached different conclusion, what would their strongest argument be?
  4. Frame challenge as valuable — make it clear that challenge strengthens insight. "Strongest objection I see is..." signals confidence and openness at once
  5. Say what would change your mind — name evidence or argument that would revise or collapse insight. This makes insight falsifiable, not just persuasive

Got: Honest statement of uncertainty that raises rather than drops audience trust. Insight is now challengeable — and so improvable.

If fail: No weakness can be spotted? That itself is warn sign. All cross-domain insights need translation between frames, and translation always loses something. If loss invisible, it has not been found yet, not avoided. Look harder at domain edges — that is where hidden assumptions live. Common hide spots: shared metaphors that work differently in each domain, stat correlations assumed causal across domain edges, and analogies that hold structurally but not quantitatively.

Validation

  • Audience was clear named and their needs shaped express
  • Form was picked by insight type and audience, not habit or convenience
  • Insight stated as coherent whole, not broken into per-domain summaries
  • Contributing domains named for check, not just credit
  • Shrinks stated clear — what was set aside and what was approximated
  • Emergent value said — what integration enables that parts do not
  • Multi-domain vocab kept rather than flattened into one domain language
  • Entry point picked for audience existing knowledge — starts where they are, bridges to where insight goes
  • Strongest reason insight might be wrong was stated
  • Insight is falsifiable — specific evidence or arguments that would revise it were named
  • Domain specialist reading their domain contribution would know it as right, not caricatured

Pitfalls

  • Domain-by-domain report: Showing each domain contribution one by one is not expressing insight — it is showing raw stuff. Insight is what shows up from combo. Lead with synthesis, then back with domain detail if needed
  • False certainty from convergence: When three domains all seem to point same way, it feels like strong evidence. But if those domains share hidden assumptions or data sources, convergence is less independent than it looks. Always check whether domains truly independent
  • Flatten to audience domain: When talking to specialist, urge is to translate whole insight into their language. This makes it open but destroys multi-domain nature. Keep texture — unfamiliar vocab is not noise, it is signal
  • Skip challenge step: Leaving out "here is why I might be wrong" feels like it makes insight stronger. It does not. It makes insight less trustworthy and less improvable. Epistemic honesty is feature, not weakness
  • Insight inflation: Claim synthesis shows more than it does. Cross-domain watch is not auto-breakthrough. Be precise about scope: "this applies to X in context Y" is more valuable than "this changes everything"
  • Premature express: Express before gestalt fully formed gives half-insights that sound integrated but fall under scrutiny. If express keeps stalling, problem is upstream in integrate-gestalt, not here
  • Hide behind complex: Use multi-domain vocab to sound fancy rather than to keep real texture. If simpler frame catches same insight without losing links, use simpler frame. Complex should be needed, not performed

See Also

  • integrate-gestalt — makes insight this skill expresses; express-insight is talk phase of synoptic cycle
  • argumentation — builds logic case for claim; express-insight says a seeing. 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 — passes known, set knowledge; express-insight sends emergent understanding just formed. Teaching transmits; expressing shows
  • shine — channels real presence into talk; express-insight can use that radiance to carry multi-domain seeing without losing warmth or honesty
  • expand-awareness — widens seeing field that makes integration possible; express-insight closes cycle by talking what that widened field showed
  • adaptic — meta-skill composing full synoptic cycle; express-insight is fifth and final step in clear-open-see-integrate-express sequence

GitHub репозиторий

pjt222/agent-almanac
Путь: i18n/caveman/skills/express-insight
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Похожие навыки

content-collections

Мета

Этот навык предоставляет проверенную в продакшене настройку для Content Collections — TypeScript-ориентированного инструмента, который преобразует файлы Markdown/MDX в типобезопасные коллекции данных с валидацией Zod. Используйте его при создании блогов, сайтов документации или контентных приложений на Vite + React для обеспечения типобезопасности и автоматической проверки содержимого. Он охватывает всё: от настройки плагина Vite и компиляции MDX до оптимизации развертывания и валидации схем.

Просмотреть навык

polymarket

Мета

Этот навык позволяет разработчикам создавать приложения на платформе прогнозных рынков Polymarket, включая интеграцию с API для торговли и получения рыночных данных. Он также обеспечивает потоковую передачу данных в реальном времени через WebSocket для отслеживания текущих сделок и рыночной активности. Используйте его для реализации торговых стратегий или создания инструментов, обрабатывающих обновления рынка в реальном времени.

Просмотреть навык

creating-opencode-plugins

Мета

Этот навык помогает разработчикам создавать плагины OpenCode, которые подключаются к более чем 25 типам событий, таким как команды, файлы и операции LSP. Он предоставляет структуру плагина, спецификации API событий и шаблоны реализации для модулей на JavaScript/TypeScript. Используйте его, когда вам нужно перехватывать, отслеживать или расширять жизненный цикл ассистента OpenCode AI с помощью пользовательской событийно-ориентированной логики.

Просмотреть навык

sglang

Мета

SGLang — это высокопроизводительный фреймворк для обслуживания больших языковых моделей (LLM), специализирующийся на быстрой структурированной генерации JSON, regex и рабочих процессов агентов с использованием кэширования префиксов RadixAttention. Он обеспечивает значительно более высокую скорость вывода, особенно для задач с повторяющимися префиксами, что делает его идеальным для сложных структурированных результатов и многократных диалогов. Выбирайте SGLang вместо альтернатив, таких как vLLM, когда вам требуется ограниченное декодирование или вы создаете приложения с интенсивным совместным использованием префиксов.

Просмотреть навык