Skip to content
cccskills
FreePublished on GitHub

signal-from-expert

Compare your notes with an expert's essays, talks, or interviews on a chosen topic. Receive exact quotes, source file locations, and an analysis that identifies connections and at least one gap in your thinking.

OriginalShow the original description

Compare the user's notes with an expert's work on a topic. Return relevant exact quotes, source locations, and at least one gap in the user's thinking. Use only when /signal-from-expert is explicitly invoked.

Run score Not tested

See how to install

Good for

  • Comparing personal notes with an expert's ideas
  • Finding overlooked questions in a proposal
  • Collecting relevant quotes with source locations
  • Saving a source-backed analysis for later review

Files included (4)

  • SKILL.md3.1 KB
  • agents/openai.yaml43 B
  • assets/essays-AGENTS.md744 B
  • scripts/fetch-sources.py4.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Signal from Expert

Inputs

Require a corpus (files or folders of the user's thinking), expert, and topic. URLs are optional. Ask for missing inputs in one plain-text question.

Workflow

1. Read the corpus

Read every named file in full with cat -n. Do not read other files for context.

2. Choose sources

Check <repo>/essays/<expert-slug>/ for saved pieces. Load the deepapi skill; if the key is unset, use your configured credential-loading method. Make 5+ separate POST /v1/search/web calls, varying <expert> <topic> queries across essays, talks, interviews, and specific sub-questions. Pick the 5–8 most relevant pieces and merge with the user's URLs and saved sources.

Show titles and URLs, one per line, and ask "go?". Wait for approval before scraping.

3. Scrape and save

From the skill directory, fetch all URLs in one batch:

python3 scripts/fetch-sources.py --expert "Paul Graham" --out <repo>/essays/paul-graham \
  https://paulgraham.com/startupideas.html https://paulgraham.com/schlep.html

The helper saves each page as NN-slug.md with a header and verbatim text. Check every head/tail preview for the real first and last lines. Remove leftover layout junk without changing the prose.

If <repo>/essays/AGENTS.md is missing, copy assets/essays-AGENTS.md there.

4. Read all sources

Read every saved source in full with cat -n before writing; use its line numbers for citations.

5. Write the analysis

Use this format with 4 numbered items by default. Repeat the item block as needed, then end with the concluding paragraph:

# DD-MM-YYYY — Signal from <Expert>

Corpus: <files>. Sources: `essays/<expert-slug>/` (N pieces). Agent analysis, not the user's words.

## 1. <Short claim; prefix with "Gap:" for a gap>

<Quote the user's relevant words and explain the connection in 1–2 lines.>

> "<Exact expert quote, 1–4 sentences>"

Full section: `essays/<expert-slug>/NN-slug.md:START-END`

**Co-founder read:** <One paragraph connecting the findings and what to do next.>
  • Include at least one Gap: item showing where the expert's work challenges the user's thinking or reveals something missing, backed by a quote.
  • Quote both people exactly; never paraphrase the user's reasoning. Keep expert quotes short and point to full passages in saved files.
  • One claim per item. Plain English. No hedging. Exclude private personal matters unrelated to the topic.

6. Save and show

Save as <corpus folder>/signal-<expert-slug>.md (a single file's parent folder). Show the full analysis in chat. Do not commit.

Failures

  • Truncated source: rerun with a higher --max-chars.
  • Poor search results: ask for URLs instead of guessing.
  • Fewer than 3 sources: say so and ask; do not pad with weak pieces.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

4x4

FreeSummary

Work through sixteen open questions in four rounds to clarify major product decisions, risky changes, or large refactors. The agent adapts later questions to earlier answers, then turns your decisions into a step-by-step implementation plan.

  • Clarifying decisions before a major product change
  • Planning a large refactor
  • Deciding rollout order for a risky change
davidondrej/skills4.2KUpdated Oct 23, 2026

adr-verbatim

FreeSummary

Document approved decisions as concise ADRs, or architecture decision records. It preserves the user's meaning and conditions, removes conversational filler, follows the project's numbering, and presents the saved record for review.

  • Record a decision approved in conversation
  • Preserve the conditions and scope of a decision
  • Add a numbered ADR to existing records
davidondrej/skills4.2KUpdated Oct 23, 2026

anti-sleep

FreeSummary

Keep a Mac awake for a chosen duration or while a specified process runs. The skill uses built-in macOS tools to manage one session, verify that sleep prevention is active, and control whether the display stays on.

  • Keep a Mac awake during a lengthy task
  • Prevent sleep while a specified process runs
  • Allow the display to dim while keeping the Mac awake
davidondrej/skills4.2KUpdated Oct 23, 2026

ask-then-build

FreeSummary

Turn a feature or refactoring idea into a concise implementation prompt for another agent. It asks focused questions one at a time, records decisions, and includes development steps, validation, and working rules.

  • Clarify requirements for a new feature
  • Decide edge cases and failure behavior
  • Define the scope of a refactor
davidondrej/skills4.2KUpdated Oct 23, 2026

bb-cli

FreeSummary

Inspect and manage BB threads, environments, projects, and plugins through its command line interface. The skill guides agents to identify the correct targets, apply changes, and verify the resulting state.

  • Check BB projects and environment status
  • Manage skills and plugins
  • Create or operate threads
davidondrej/skills4.2KUpdated Oct 23, 2026

bb-plugins

FreeSummary

Create, install, and debug TypeScript plugins that extend bb with custom pages, sidebar panels, CLI commands, agent tools, themes, and other features. The skill also guides development reloads, log checks, and verification of installed plugins.

  • Add a custom page or sidebar panel to bb
  • Create a bb CLI command or agent tool
  • Investigate plugin errors through logs
davidondrej/skills4.2KUpdated Oct 23, 2026

See all skills by davidondrej

Report a problem with this skill