upstream-sync

Check cortextOS framework upstream changes, summarize diffs, and require approval before applying.

88|108|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/grandamenium/cortextos --skill upstream-sync-grandamenium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upstream-sync
Source: https://github.com/grandamenium/cortextos/tree/main/templates/analyst/.claude/skills/upstream-sync
Command: npx skills add https://github.com/grandamenium/cortextos --skill upstream-sync-grandamenium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents unexpected changes to the cortextOS framework by checking upstream for updates, explaining every modification clearly, and requiring explicit approval before applying them.

Core Features & Use Cases

  • Upstream change intelligence: Fetches remote framework updates, summarizes them into categorized JSON, and explains the full diff in plain English.
  • No auto-merges, approval-gated applies: Never auto-merges and only applies when the user explicitly confirms.
  • Security audit gate: Runs npm audit at a moderate severity threshold and blocks the merge if vulnerabilities are found.
  • Post-merge verification: Ensures build and tests pass and reports results, including any template or bootstrap file implications.
  • Operational safeguards: Avoids applying changes during configured night mode windows.

Quick Start

Tell the agent “Check for upstream cortextOS framework updates and ask me before applying anything.”

Frequently Asked Questions about upstream-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review upstream framework updates before applying them?

Reviewing upstream framework updates involves fetching remote changes, summarizing categorized diffs into JSON, and explaining modifications in plain English for explicit approval. The process prevents unexpected modifications by never auto-merging and requiring user confirmation before applying anything.

How does an npm audit security gate work during framework updates?

An npm audit security gate runs at a moderate severity threshold during the update process and blocks the merge if vulnerabilities are found. This ensures upstream changes containing known security issues cannot be applied to your framework.

Can I automatically sync framework updates without manual approval?

No, automatic syncing without manual approval is not supported. The process is strictly approval-gated, meaning it only applies updates when you explicitly confirm them, preventing unexpected changes to the framework.

What happens after an upstream merge is applied to the framework?

After an upstream merge is applied, post-merge verification ensures builds and tests pass and reports the results. This includes reporting any implications for template or bootstrap files affected by the framework update.

Are there time restrictions on when framework updates can be applied?

Yes, operational safeguards respect configured day_mode_start and day_mode_end times to avoid applying changes during night mode windows. This prevents disruptive framework updates during off-hours.