AGENT SKILL

idea-ingest

Ingest links, articles, tweets, and ideas into the brain. Fetch content, save to brain with analysis, create author people page, and cross-link. Use when the user shares a link or says "read this", "save this", "think about this".

License 许可
MIT
最近更新
2026-04-26
Stars
★ 0
Forks
0

01 前言 Front Matter

name
idea-ingest
tools
[ "search", "query", "get_page", "put_page", "add_link", "add_timeline_entry", "file_upload" ]
version
1.0.0
mutating
true
triggers
[ "shares a link or URL", "read this", "save this", "think about this", "put this in brain" ]
writes_to
[ "people/", "concepts/", "sources/" ]
description
Ingest links, articles, tweets, and ideas into the brain. Fetch content, save to brain with analysis, create author people page, and cross-link. Use when the user shares a link or says "read this", "save this", "think about this".
writes_pages
true

03 SKILL.md 正文

Idea Ingest Skill

Filing rule: Read skills/_brain-filing-rules.md before creating any new page.

Contract

This skill guarantees:

  • Every ingested item has a brain page with genuine analysis (not just a summary)
  • The author gets a people page (MANDATORY for anyone whose thinking is worth ingesting)
  • Cross-links created bidirectionally (source ↔ author, source ↔ mentioned entities)
  • Raw source preserved for provenance via gbrain files upload-raw <!-- QMD-adapted: in QMD local mode, use local file copy instead of cloud upload -->
  • Every fact has an inline [Source: ...] citation
  • Filing follows primary subject rules (not format-based)

Convention: See skills/conventions/quality.md for Iron Law back-linking.

Every mention of a person or company with a brain page MUST create a back-link. Format: - **YYYY-MM-DD** | Referenced in [page title](path) — brief context

Phases

  1. Fetch the content. Use appropriate tools for the content type (web fetch for articles, API for tweets, PDF reader for documents).

  2. Upload raw source. Save the fetched content for provenance: gbrain files upload-raw <file> --page <slug> <!-- QMD-adapted: in QMD local mode, copy to local data dir instead of cloud upload -->

  3. Identify the author — MANDATORY people page. Anyone whose thinking is worth ingesting is worth tracking.

    • Search brain for existing author page
    • If no page → CREATE ONE with compiled truth + timeline format
    • If page exists → update timeline with this new publication
    • Cross-link both directions
  4. Save to brain. File by PRIMARY SUBJECT (read skills/_brain-filing-rules.md):

    • About a person → people/
    • About a company → companies/
    • A reusable framework → concepts/
    • Raw data dump → sources/
  5. Analyze for the user. Reply with analysis that connects the content to what the brain knows. Think about:

    • Active projects — is this relevant?
    • Contradictions — does this challenge existing brain knowledge?
    • Connections — does this involve known people/companies?
    • Don't just summarize. Tell the user things they wouldn't have noticed.
  6. Sync. gbrain sync to update the index.

Output Format

# {Title} — {Author}

**Source:** {URL}
**Author:** {Author}, {role}
**Published:** {date}
**Ingested:** {date}

## Context
{Why this matters now, connected to brain knowledge}

## Summary
{3-5 bullet core arguments}

## Key Data / Claims
{Specific facts, numbers, quotes}

## Analysis
{How this connects to existing brain knowledge. What's new. What contradicts.}

Anti-Patterns

  • Just summarizing without connecting to brain knowledge
  • Filing everything in sources/ (sources is for raw data dumps only)
  • Skipping the author people page
  • Not cross-linking to mentioned entities
  • Ingesting without checking brain first for existing coverage

04 同仓库更多 Skills

sixtycat2000-ctrl
sixtycat2000-ctrl/gbrain-qmd

webhook-transforms

Generic framework for converting external events (SMS, meetings, social mentions) into brain-ingestible signals. Define a transform function, register a webhook URL, and incoming events get processed through the brain pipeline.

★ 0
sixtycat2000-ctrl
sixtycat2000-ctrl/gbrain-qmd

testing

Skill validation framework. Validates every skill has SKILL.md with frontmatter, every reference exists, every env var is declared. The testing contract for the skill system itself.

律师与法务测试与质量Skill与智能体开发
★ 0
sixtycat2000-ctrl
sixtycat2000-ctrl/gbrain-qmd

soul-audit

6-phase interactive interview that generates the agent's identity (SOUL.md), user profile (USER.md), access control (ACCESS_POLICY.md), and operational cadence (HEARTBEAT.md). Re-runnable anytime to update any section.

Skill与智能体开发
★ 0
sixtycat2000-ctrl
sixtycat2000-ctrl/gbrain-qmd

smoke-test

Post-restart smoke tests + auto-fix for gbrain and OpenClaw environments. Tests critical services, auto-fixes known issues, extensible via user-defined test scripts in ~/.gbrain/smoke-tests.d/*.sh.

测试与质量
★ 0
sixtycat2000-ctrl
sixtycat2000-ctrl/gbrain-qmd

skillpack-check

Run `gbrain skillpack-check` to produce an agent-readable JSON health report for the gbrain install. Wraps `gbrain doctor` + `gbrain apply-migrations --list` so a host agent (your OpenClaw's morning-briefing, any OpenClaw cron) can see at a glance whether the skillpack needs attention. Use when the user asks "is gbrain healthy?", when a cron fires a morning check, or proactively when something seems off (jobs not running, brain not updating, autopilot silent).

★ 0
sixtycat2000-ctrl
sixtycat2000-ctrl/gbrain-qmd

skillify

The meta skill. Turn any raw feature or script into a properly-skilled, tested, resolvable, evaled unit of agent-visible capability. Use when the user says "skillify this", "is this a skill?", "make this proper", or after a new feature is built without the full skill infrastructure. Paired with `gbrain check-resolvable`, skillify gives a user-controllable equivalent of Hermes' auto-skill-creation: you build, skillify checks the checklist, check-resolvable verifies nothing is orphaned. The human keeps judgment; the tooling keeps the checklist honest.

Skill与智能体开发
★ 0