{"slug":"update-cog","title":"update-cog","summary":"Check for and apply upstream COG framework updates (skills, docs, scripts) without touching personal content","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-28T15:11:33.146131Z","repo":{"url":"https://github.com/huytieu/COG-second-brain","stars":1236,"forks":147,"license":"MIT","updatedAt":"2026-09-28T08:52:07Z"},"bodyHtml":"
\n

name: update-cog\ndescription: Check for and apply upstream COG framework updates (skills, docs, scripts) without touching personal content\nroles: [all]\nintegrations: [git]

\n

COG Update Skill

\n

Purpose

\n

Help the user update their COG framework files (skills, documentation, scripts) from the official upstream repository without risking their personal content (braindumps, profiles, notes).

\n

When to Invoke

\n\n

Process Flow

\n

1. Check Current Version

\n

Read COG-VERSION from the vault root. If it doesn't exist, inform the user they may be on an older version that predates version tracking.

\n

2. Ensure Upstream Remote

\n
# Add the upstream remote if not already present\ngit remote get-url cog-upstream 2>/dev/null || \\\n  git remote add cog-upstream https://github.com/huytieu/COG-second-brain.git\n\n# Fetch latest\ngit fetch cog-upstream main --quiet\n
\n

3. Compare Versions

\n
# Local version\ncat COG-VERSION\n\n# Upstream version\ngit show cog-upstream/main:COG-VERSION\n
\n

If versions match, tell the user they're up to date.

\n

4. Show What Changed

\n

For each framework file, compare local vs upstream:

\n
git diff HEAD..cog-upstream/main -- <file>\n
\n

Framework files (safe to update — never contain user content):

\n\n

5. Detect Customizations

\n

Before updating, check if the user has customized any framework files:

\n
# Show how the working tree differs from current upstream HEAD.\n# NOTE: this cannot tell a local customization apart from an upstream\n# change you have not pulled yet — both show up as a diff. Treat any\n# output as \"needs a look\", not as proof the user edited the file.\ngit diff cog-upstream/main -- <file>\n
\n

If a file differs, warn the user and offer options:

\n\n

6. Apply Updates

\n

For files the user approves:

\n
# Surgical file replacement — no merge, no rebase, zero conflict risk\ngit checkout cog-upstream/main -- <file>\n
\n

7. Verify & Summarize

\n

After updating:

\n\n

Alternative: Shell Script

\n

For users who prefer a non-AI update, mention the update script:

\n
./cog-update.sh           # Interactive\n./cog-update.sh --check   # Just check for updates\n./cog-update.sh --dry-run # Preview changes\n./cog-update.sh --force   # Update everything\n
\n

Important Notes

\n\n","files":[{"path":"SKILL.md","sizeBytes":3715,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-28T15:12:27.251946Z","sha256":"6314A13A6942A4E4AE77087F1B2586055B40420B6AC7B980D58855A5837E0924","sizeBytes":1865},"review":null,"source":{"repositoryUrl":"https://github.com/huytieu/COG-second-brain","path":"skills/update-cog","license":"MIT","commit":"4cdb6015dc6eb66f74bac513856ff6446ecb5d1b","subtreeSha":"5436A742370657B3C272C459F95D2E69BBE317D3C87D8FC578D5B21776D13AB9","lastSyncedAt":"2026-09-28T15:11:28.148164Z"},"reviewedAt":"2026-09-28T15:13:46.631856Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/huytieu/COG-second-brain/tree/main/skills/update-cog"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install huytieu-cog-second-brain@llmmart"},{"target":"git","command":"git clone https://github.com/huytieu/COG-second-brain.git"}]}