← Back to Skills Marketplace
toliuweijing

Founder Signal

by Jim Liu · GitHub ↗ · v0.1.15 · MIT-0
cross-platform ✓ Security Clean
111
Downloads
0
Stars
0
Active Installs
16
Versions
Install in OpenClaw
/install founder-signal
Description
Founder Signal turns verified Reddit evidence into a small, reviewable signal package for founders evaluating product demand and positioning across one or mo...
README (SKILL.md)

Founder Signal OpenClaw Skill

Use this skill to turn verified Reddit evidence into a small, reviewable signal package for founders evaluating product demand and positioning across one or more configured product profiles.

Founder Signal Invariant

No saved verified snapshot means no scoring and no draft.

Every run must persist a run folder before later steps execute so failures still leave traceable artifacts. The skill should only score verified evidence and should only prepare a Draft handoff after daily-review.md exists for the selected profile. Actual public Draft publication requires explicit founder confirmation.

Inputs

  • one or more active product profiles from profiles/*.json
  • optional --profile \x3Cprofile_id> selection for single-profile runs
  • deterministic Eddrit discovery from profile subreddits, keywords, and scoring_terms; discovery always runs before configured hints
  • optional excluded_reddit_urls in a profile to suppress known old candidates
  • optional verified_evidence_snapshots in a profile when a Claw/browser agent has verified a Reddit post but the mirror fetch is blocked

Draft Publish Handoff

Founder Signal depends on the canonical draft-cli skill for public Draft page publication. Draft handoff preparation is on by default: when Founder Signal creates daily-review.md, it also writes draft-publish-intent.json next to daily-review.md and does not hardcode Draft CLI subcommands. The intent contains the artifact path, title, profile, public visibility request, and requires_confirmation: true.

The agent must not invoke draft-cli public publish immediately after the intent is written. It must first show the founder what would become public, or clearly point to daily-review.md, then ask for explicit publish approval. This prevents unused public Draft pages from occupying cloud storage and keeps the public boundary reviewable.

The draft-cli skill is the source of truth for daemon readiness, page creation, append/patch behavior, public publishing, invite codes, and Draft URL extraction.

E2E Verification Playbook

When the founder asks for an end-to-end verification run, the agent must deliver a public Draft URL or clearly report E2E incomplete.

  1. Enable the target profiles.
  2. Use the built-in discovery phase. Do not start from placeholder URLs.
  3. Try the normal Eddrit search/listing and post mirror paths first.
  4. If the mirror is blocked, use browser/manual verification and add verified_evidence_snapshots to the profile:
{
  "reddit_url": "https://www.reddit.com/r/ChatGPT/comments/abc123/real_slug/",
  "verification_method": "agent_browser",
  "verified_by": "openclaw-agent",
  "text_snapshot": "Copy the relevant Reddit post text observed by the agent here."
}

The snapshot must be real source text from the Reddit post, not invented content. Placeholder URLs such as POST_ID, REAL_ID, SUB, or /slug/ are invalid and must not be used. Founder Signal treats verified_read_via_agent_browser and verified_read_via_manual_snapshot as verified reads only after the snapshot is persisted.

Run E2E checks with:

bash scripts/run_founder_signal_once.sh --all --require-action-card --require-publish-intent

When the run creates draft-publish-intent.json, inspect its requires_confirmation field. If it is true, show the founder the public-boundary summary and ask for approval before invoking the required draft-cli skill. After approval, publish daily-review.md publicly and return the resulting public Draft URL to the founder. This Draft handoff preparation is part of normal Founder Signal operation, but the public publish action is confirmation-gated.

Outputs

  • runs/\x3CRUN_ID>/run.json
  • runs/\x3CRUN_ID>/REPORT.md
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/run.json
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/REPORT.md
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/evidence/
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/outputs/candidates.json
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/selected-candidate.json when a verified candidate is selected
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/daily-review.md when an Action Card is generated
  • runs/\x3CRUN_ID>/profiles/\x3Cprofile_id>/draft-publish-intent.json when public Draft publishing is prepared and awaiting confirmation
  • state/past-candidates.json as private local candidate history used to avoid repeat candidates in future runs

Manual Execution

bash scripts/run_founder_signal_once.sh
bash scripts/run_founder_signal_once.sh --profile draft
bash scripts/run_founder_signal_once.sh --all --require-action-card --require-publish-intent

Without --profile, the runner processes all enabled profiles.

Bundled Runtime Payload

This published skill package includes the minimum local runtime payload needed to run from the installed skill directory:

  • scripts/run_founder_signal_once.sh
  • src/founder_signal/
  • profiles/README.md
  • profiles/draft.example.json

Before a real run, copy at least one example profile to an active .json file under profiles/. No Draft publish settings file is required; Draft review is part of the default flow.

Runtime Order

  1. Load either all enabled profiles or one selected profile.
  2. For each profile, run deterministic Eddrit discovery from subreddits and keywords, skipping profile exclusions and previous local candidate history, then consider real configured hints and verified snapshot fallbacks.
  3. Save evidence from mirror or verified snapshot fallback, enforce the verified-read gate, score only verified candidates, and optionally generate an Action Card.
  4. Write a public Draft publish intent whenever daily-review.md exists, marked as requiring confirmation before public publish.

Eddrit search/listing and post mirror pages are the primary source read layer. Reddit direct JSON or HTML, Redlib, and browser fallback are diagnostic or future fallback paths only.

Usage Guidance
This skill appears safe to install for its stated purpose. Before using it, make sure you trust the Draft CLI dependency, review any generated `daily-review.md` before approving public publication, and remember that local run folders and candidate history are retained until you delete them.
Capability Assessment
Purpose & Capability
The skill's stated purpose—finding verified Reddit evidence, scoring it, and producing a founder review package—matches the shown scripts and Python modules.
Instruction Scope
The skill prepares a public Draft publishing handoff, but its instructions explicitly require showing the review artifact and getting founder approval before publishing.
Install Mechanism
Installation uses an external npm package to provide the draft CLI; this is purpose-aligned but users should trust that package source.
Credentials
Network fetching from Eddrit/Reddit mirrors and local run/log output are expected for the stated research workflow and appear scoped to configured profiles.
Persistence & Privilege
The skill stores local run artifacts and candidate history for future deduplication; this is disclosed and bounded, but users should be aware of retention.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install founder-signal
  3. After installation, invoke the skill by name or use /founder-signal
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.15
Version 0.1.15 - Updated skill version metadata from 0.1.14 to 0.1.15. - Documentation and support files updated; no functional changes to core logic.
v0.1.14
founder-signal 0.1.14 - Update version to 0.1.14 in SKILL.md. - No functional or behavioral code changes included.
v0.1.13
- Added two new example product profiles: `hitrl-remote-agents.example.json` and `reusable-ai-insights.example.json`. - Updated and reorganized profile documentation and examples in the `profiles` directory. - Minor changes to scoring logic, candidate discovery, and model code to support new example profiles. - Incremented version to 0.1.13.
v0.1.12
Version 0.1.12 - Updated version to 0.1.12 in SKILL.md. - General code and documentation maintenance across multiple source files. - No major user-facing features or breaking changes introduced.
v0.1.11
- Adds private local candidate history (`state/past-candidates.json`) to avoid repeat candidates in future runs. - Supports `excluded_reddit_urls` field in profiles to suppress known old candidates from discovery and selection. - Discovery logic now skips candidates that match local history or exclusion lists, improving review freshness. - Documentation updated to explain new candidate history and exclusion features. - Minor code refactors and one new source file (`candidate_history.py`) to support these changes.
v0.1.10
Founder-facing Draft publishing is now confirmation-gated. - Prepares Draft publish intent with requires_confirmation: true, instead of immediately approving public publish. - Agent must now show the prepared draft and request founder approval before invoking downstream draft-cli publication. - Ensures unused or unapproved public draft pages are not created without explicit confirmation. - Updated docs to clarify confirmation workflow and that public boundary is always reviewable by the founder before publishing.
v0.1.9
- Draft publishing is now enabled by default; no extra user setup is required. - Shared Draft runtime settings and local publish configuration are removed; public Draft handoff always happens when an Action Card is generated. - Documentation and skill manifest updated to clarify that Draft is the default review flow and not an optional add-on. - Minor cleanup and consolidation of input requirements and runtime order in documentation.
v0.1.8
- Adds deterministic Reddit candidate discovery via Eddrit based on profile subreddits, keywords, and scoring terms; always runs before using configured hints or snapshots. - Clarifies that placeholder Reddit URLs (like POST_ID, REAL_ID, SUB, or slug) and invented content are invalid in profiles and evidence snapshots. - Updates E2E workflow and documentation to require real Reddit discovery and valid snapshots; placeholder and non-deterministic URLs are explicitly disallowed. - Improves documentation on the discovery phase, verified evidence snapshot usage, and overall runtime order. - Tightens enforcement of valid, verified Reddit snapshots for evidence and candidate scoring.
v0.1.7
- Adds support for browser/manual verification fallback with `verified_evidence_snapshots` when Reddit mirror fetch is blocked. - Documents new E2E verification flow, including steps for using snapshots and stricter requirements for public Draft publishing. - Updates manual execution instructions to support new flags (`--all`, `--require-action-card`, `--require-publish-intent`). - Clarifies primary vs. fallback evidence sources and handling for agent/browser-verified snapshots. - Expands SKILL.md with detailed verification and publishing instructions.
v0.1.6
Version 0.1.6 - Minor updates to documentation in SKILL.md, including formatting changes and removal of legacy instructions around Draft CLI command syntax. - Cleaned up advanced/legacy details in the Shared Runtime Settings section. - No user-facing changes to skill usage or outputs. - Internal and documentation updates only—functionality remains the same.
v0.1.5
- Added explicit public Draft publishing intent: writes draft-publish-intent.json instead of invoking Draft CLI commands directly. - Updated SKILL.md and runtime to delegate publishing to the draft-cli skill, clarifying public publishing flow and removing hardcoded CLI subcommands. - Shared runtime config is now optional; missing config no longer blocks runs. - Maintains legacy draft_publish_command as an advanced override, but promotes "draft_publish": "public" as the main user setting. - Output and documentation updated to describe new handoff and artifact paths for Draft publish requests.
v0.1.4
Minor runtime initialization improvements and packaging tweaks. - Now auto-creates `founder-signal.local.json.example` if missing on first run, ensuring example config is always available. - Clarified configuration and packaging details in docs, noting the runtime template is always bundled and recreated if absent. - Removed redundant packaging of the root example config; only the runtime template under `src/founder_signal` is required. - No end-user workflow or interface changes.
v0.1.3
- Updates the default location for the shared config example from config/ to profiles/. - SKILL.md now references profiles/founder-signal.local.json.example as the canonical sample config. - Bundled runtime payload and documentation updated for consistency with the new config location. - No functional logic changes—documentation and configuration path update only.
v0.1.2
Founder Signal 0.1.2 improves local config fallback and skill packaging. - Adds fallback to packaged example config under config/ if root-level config is missing. - Updates SKILL.md to clarify bundled payload, including config/founder-signal.local.json.example for reliable setup. - No changes required to runtime behavior for existing setups.
v0.1.1
- Bundled a minimal local runtime payload, including example config and profile files, to support out-of-the-box execution after installation. - Added scripts and Python modules under src/founder_signal/ for streamlined running and modularity. - Provided example configuration files and updated documentation to guide initial setup. - No changes to user-facing functionality; this release focuses on packaging improvements for easier adoption and local testing.
v0.1.0
Founder Signal initial release - Introduces verified Reddit evidence collection for founder product research. - Generates reviewable signal packages and scored review artifacts. - Supports multiple product profiles with configurable settings and profile selection. - Integrates Draft CLI for publishing generated reviews; depends on canonical readiness checks. - Persists run folders and outputs detailed artifacts for each run and profile, including evidence, scoring, and publish status. - Provides clear manual execution options and output structure.
Metadata
Slug founder-signal
Version 0.1.15
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 16
Frequently Asked Questions

What is Founder Signal?

Founder Signal turns verified Reddit evidence into a small, reviewable signal package for founders evaluating product demand and positioning across one or mo... It is an AI Agent Skill for Claude Code / OpenClaw, with 111 downloads so far.

How do I install Founder Signal?

Run "/install founder-signal" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Founder Signal free?

Yes, Founder Signal is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Founder Signal support?

Founder Signal is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Founder Signal?

It is built and maintained by Jim Liu (@toliuweijing); the current version is v0.1.15.

💬 Comments