Does cog-second-brain auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Is cog-second-brain free?

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Productivity

Plugin

cog-second-brain

Cognition + Obsidian + Git — A self-evolving second brain powered by AI agents, markdown files, and version control. No database, no vendor lock-in — just .md files that think.

BOOST

huytieu@huytieu

GitHub

Plugin Signal88/100Strong

maintained97

capable80

documented100

adopted66

Install

$ npx -y skills add huytieu/COG-second-brain --agent claude-code

Stats

HTML Bash Git GitHub Markdown

+7 tags

Anthropic OpenAI Gemini Slack Notion Jira Obsidian

1,266

Stars

152

Forks

Active

Maintenance

Python

Language

MIT

License

6d ago

Last commit

11mo ago

Created

20h ago

Added

Repo: huytieu/COG-second-brain

In this plugin

36 skills 10 agents

See everything inside

What's inside

COG: The Agentic Second Brain That Actually Self-Evolves

Cognition + Obsidian + Git — A self-evolving second brain powered by AI agents, markdown files, and version control. No database, no vendor lock-in — just .md files that think.

Quick Start | Skills | Features | FAQ | SETUP.md

Works with Claude Code • Antigravity • Cursor • Kiro • Gemini CLI • OpenAI Codex • any AI that reads markdown

Inspired by Garry Tan's gstack and gbrain

graph LR
    A[You] -- natural language --> B[AI Agent]
    B -- runs --> C[33 Skills]
    C -- delegates to --> W[6 Workers]
    C -- verified by --> V[4 Read-Only Verifiers]
    C -- reads & writes --> D[.md Files]
    W -- reads & writes --> D
    V -- observes --> D
    C -- syncs with --> G[GitHub / Linear / Slack / PostHog]
    D --> E[Git]
    D --> F[iCloud]

Quick Start

1. Clone & enter the repo:

git clone https://github.com/huytieu/COG-second-brain.git
cd COG-second-brain

2. Run onboarding in your agent:

Agent	Command	How it finds skills
Claude Code	`code .` → "Run onboarding"	`.claude/skills/`
Antigravity	Open folder → "Run onboarding"	`.agents/skills/` + `.agents/rules/cog.md`
Cursor	Open folder → "Run onboarding"	`.cursor-plugin/` + `.cursorrules`
Kiro	Open folder → "setup COG"	`.kiro/powers/`
Gemini CLI	`gemini` → `/onboarding`	`GEMINI.md` + `.gemini/commands/`
OpenAI Codex	`codex` → "Run onboarding"	`AGENTS.md`
Other agents	Point at `AGENTS.md` → "Run onboarding"	`AGENTS.md`

Or install via skills.sh:

npx skills add huytieu/COG-second-brain

Done — COG is personalized and ready in ~2 minutes. See SETUP.md for optional config (Git sync, iCloud, Obsidian Tasks, etc.).

Agent Support Matrix

COG ships a full Claude Code surface, a full Antigravity surface, plus core native surfaces for Kiro and Gemini CLI, with AGENTS.md as the universal fallback for Codex and other markdown-reading agents.

Surface	Current support	Notes
Claude Code	33 native skills + 10 agents (6 workers + 4 verifiers)	Full first-class surface
Antigravity	33 skills + 10 agents (pointer-stub format)	Full surface — thin stubs in `.agents/` delegate to the `.claude/` playbooks, which stay authoritative
Agent Plugins standard	Root `plugin.json` + `skills/` (33 skills)	Spec 1.0.0 conformant; any standard-aware client loads COG as a plugin
Cursor	Plugin manifest + rules	`.cursor-plugin/plugin.json` + `.cursorrules`
Kiro	7 native powers	Core workflows today
Gemini CLI	7 native commands	Core workflows today
`AGENTS.md`	33 documented commands	Universal fallback for Codex and other agents

Before publishing or updating framework files, run ./scripts/validate-agent-surface.sh to catch drift between manifests, docs, and shipped files. See docs/AGENT-SUPPORT.md for the detailed support matrix and contributor rules.

Skills

Core Skills (Personal Knowledge)

Skill	What it does	Try saying...
onboarding	Personalize COG for your workflow (run first!)	"Run onboarding"
braindump	Capture raw thoughts with intelligent classification	"I need to braindump"
daily-brief	Verified news intelligence (7-day freshness)	"Give me my daily brief"
url-dump	Save URLs with auto-extracted insights	"Save this URL"
weekly-checkin	Cross-domain pattern analysis	"Weekly review"
knowledge-consolidation	Build frameworks from scattered notes	"Consolidate my knowledge"
update-cog	Update framework files without touching your content	"Update COG"
memory-hygiene	Trust sweep of persistent memory — re-verify claims against the live environment, stamp `last_verified` + confidence	"Audit my memories"

Team Intelligence Skills (for Product & Engineering Leads)

Skill	What it does	Try saying...
team-brief	Cross-reference GitHub + Linear + Slack + PostHog into a daily team intelligence brief with two-way Linear sync-back	"Team brief" / "What did we ship?"
meeting-transcript	Process meeting recordings into structured decisions, action items, and team dynamics	"Process this meeting"
comprehensive-analysis	Deep 7-day analysis for weekly reviews, board prep, or strategic planning (~8-12 min)	"Weekly analysis" / "Board prep"

PM Workflow Skills (for Product Managers)

Skill	What it does	Try saying...
create-user-story	Create user stories with duplicate checking across Linear, GitHub Issues, or Jira	"Create a user story for..."
generate-prd	Draft PRDs with approval gate before publishing to Confluence/Notion	"Generate a PRD for..."
generate-release-notes	Generate release notes from GitHub milestones, Linear cycles, or manual input	"Generate release notes for v2.1"
export-open-issues	Audit and export open issues from any tracker into a structured vault summary	"Export open issues"
publish-to-confluence	Publish any vault markdown file to Confluence	"Publish this to Confluence"
update-knowledge-base	Maintain product knowledge base from releases, features, and project changes	"Update the knowledge base with v2.1 changes"

PM Workflow: These skills form a complete product management lifecycle: Research (/auto-research) → PRD (/generate-prd) → Stories (/create-user-story) → Development → Release Notes (/generate-release-notes) → Knowledge Base (/update-knowledge-base). Use /export-open-issues for audits and /publish-to-confluence to share externally.

Strategic Research

Skill	What it does	Try saying...
auto-research	Deep strategic research engine — decomposes questions into parallel research threads with multiple agents	"Research the future of AI testing tools"

Content Creation

Skill	What it does	Try saying...
content-factory	Autonomous content pipeline — scout announcements, triage by trend momentum + your unique angle, publish with ledger dedup, hard volume caps, and screenshot-verified posting	"Run the content factory"

Verification Harness

Opt-in. Ask for one of these and work walks a V: decompose left into falsifiable criteria, build at the apex, verify right with evidence traced back to each criterion. Say nothing and none of it runs: ordinary work carries no checkpoints and no evidence ledger. Turn it on per request, or by default for build tasks with verification_harness: on in 00-inbox/MY-PROFILE.md. Full lifecycle in WORKFLOW.md.

Skill	What it does	Try saying...
closed-loop	Plan → build → component verify → integration verify → acceptance. The worker never grades its own homework; verifiers observe the artifact, not the worker's summary	"Run this through the closed loop"
ultragoal	A goal too big for one session, run as a chain of phases with cross-session state and a north-star acceptance gate	"Track this as an ultragoal"
harvest	Capture session learnings, stage them for approval, propose skill patches. Never writes durable knowledge unapproved	"Harvest what we learned"
retro	Audit the run's checkpoints and evidence quality. A run can pass every gate on weak observations	"Retro this run"
review-cockpit	One living doc per multi-item session: progress, per-item cards, and an approval slot you edit in place	"Set up a review cockpit"

Craft Skills (Writing & Visuals)

Skill	What it does	Try saying...
no-ai-slop	Sharpen a draft without flattening its voice, or just detect AI-slop patterns	"Make this less AI-sounding"
slop-gate	Refuse slop tells in anything about to be written, published, or sent; runs in CI or as a hook	"Scan this before I publish"
voice-baseline	Measure the words and shapes you over-use so an agent stops amplifying your tics	"Why do my drafts all sound the same?"
release-video	Turn a release into a motion recap and explained per-feature demos, with sound tied to motion	"Make a video for this release"
editorial-illustrations	Claim → geometry: derive the right figure from what the text argues, render it as self-contained theme-aware HTML/SVG	"Make a diagram for this argument"
data-forms	20+ chart and diagram forms with when-to-use, failure modes, and the encoding discipline that makes any of them readable	"The bar chart is burying the point"
museum-art	Real public-domain artwork from museum open-access APIs instead of AI-generated or stock imagery	"Find a hero image for this post"
daily-journal	A passive work journal the agent keeps for you, plus a guided reflection on request	"Reflect on today"

Design Skills (Anti-Slop UI)

A paired set. taste-skill owns first-impression surfaces, product-ui-taste owns surfaces people use every day. Never run both on the same component.

Skill	Owns	Try saying...
taste-skill	Landing pages, portfolios, marketing, editorial. States a "Design Read" before writing code so it stops defaulting to one house aesthetic	"Build a landing page for this"
product-ui-taste	Dashboards, data tables, forms, wizards, settings, admin consoles. Budgets the frame in px first, then survives real data: overflow, long labels, empty/error/permission-denied states	"Build the admin table for this"

Agents (Specialist Sessions)

COG uses a worker agent architecture inspired by garrytan/gstack specialist sessions and garrytan/gbrain knowledge patterns. Workers handle data-heavy tasks cheaply (Sonnet) while the lead session does reasoning (Opus).

Agent	What it does	Model
worker-data-collector	Structured extraction from GitHub, Slack, Jira, Linear	Sonnet
worker-researcher	Web research with source citations	Sonnet
worker-file-ops	Vault file operations, metadata, profiles	Sonnet
worker-executor	Pre-approved mutations (Jira, Linear, APIs)	Sonnet
worker-publisher	Publishing to Slack, Confluence, Notion	Sonnet
brief-people-updater	Batch-update people profiles from meetings/briefs	Sonnet

Read-only verifiers (they cannot edit files or mutate external state):

Agent	What it does	Checkpoint
task-verifier	Checks output against acceptance criteria by observing the artifact	CP-3v
integration-verifier	Cross-task wiring and global acceptance	CP-4
fix-agent	Targeted fixes after a `FAIL:fixable` verdict; max 2 attempts	CP-3v retry
harvest-curator	Shapes session learnings into adoption notes; propose-only	CP-7

Workers write results to /tmp/ files and return only a status + path. The lead reads the file for synthesis. This eliminates slow token generation in agent output.

Verifiers receive paths only, never a worker's output. Pasted context induces narrativisation: the verifier classifies the framing instead of independently reading the source.

People CRM (Knowledge-Based Team Profiles)

File tree

FAQ

cog-second-brain is a Claude Code plugin with 36 hand-picked skills for productivity work, indexed on Flowy. Install it with the command on its page. It includes auto-research, braindump, closed-loop. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is cog-second-brain?: Cognition + Obsidian + Git — A self-evolving second brain powered by AI agents, markdown files, and version control. No database, no vendor lock-in — just .md files that think.
How do I install cog-second-brain?: Run these in Claude Code: npx -y skills add huytieu/COG-second-brain --agent claude-code. Then prompt normally.
Does cog-second-brain auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is cog-second-brain free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Is this plugin yours?

Claim it with GitHub Submit a plugin Promote it