Agent skill

Upstream Sync

by grandamenium in grandamenium/cortextos

Check for cortextOS framework updates from the remote repo. An agent skill from grandamenium/cortextos.

MITAuto-check passedWriting & Content

Install Upstream Sync

skills CLI
$ npx skills add grandamenium/cortextos --skill upstream-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install grandamenium/cortextos upstream-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community/skills/upstream-sync .claude/skills/upstream-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
upstream-sync
GitHub stars
101
Token cost
~501 tokens
SKILL.md length
215 words
Files
1
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Check for cortextOS framework updates from the remote repo. An agent skill from grandamenium/cortextos.

  • Works in 4 steps: Check for updates → If updates available → Apply (only after approval) → …
  • Tasks that involve Plain language and style rules
  • SKILL.md covers When to Run, Workflow, Config and Safety
  • Calls git

What it does

Upstream Sync is an agent skill from grandamenium/cortextos. Check for cortextOS framework updates from the remote repo. Fetches changes, categorizes them, explains in plain English, and applies only with user approval.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Plain language and style rules. The licence is MIT.

When your agent uses it

  • Tasks that involve Plain language and style rules

Example prompts

  • “/upstream-sync”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Check for updates
  2. If updates available
  3. Apply (only after approval)
  4. Post-apply

What it can do on your machine

Read from SKILL.md and the folder at commit 6f93838. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Upstream Sync loads about 501 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~501

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 215 words, ~501 tokens.

Download SKILL.mdSave it as .claude/skills/upstream-sync/SKILL.md (or your agent's skills folder).
name
upstream-sync
description
Check for cortextOS framework updates from the remote repo. Fetches changes, categorizes them, explains in plain English, and applies only with user approval.
triggers
upstream, framework update, check updates, new version, pull changes
external_calls
github.com

Upstream Sync

Check for cortextOS framework updates from the remote repository. Never auto-merges. Always explains changes and waits for approval.

When to Run

  • Daily cron (configured via cortextos bus add-cron)
  • When user asks about updates
  • After hearing about new cortextOS features

Workflow

Step 1: Check for updates
bash
RESULT=$(cortextos bus check-upstream)

The script fetches from upstream and returns a JSON summary categorizing changes by type (bus scripts, templates, skills, dashboard, etc.).

Step 2: If updates available
  1. Read the JSON output to understand what changed
  2. If catalog_additions array is present, note those new community items separately — surface them to user after the framework update conversation
  3. Read the actual diff: git diff HEAD..upstream/main
  4. Explain EVERY change in plain English to the user via Telegram
  5. Categorize: security fix, new feature, template change, breaking change
  6. Recommend: "safe to apply" or "review needed because..."
  7. Wait for explicit "yes" from the user
Step 3: Apply (only after approval)
bash
cortextos bus check-upstream --apply
Step 4: Post-apply
  • Verify the merge was clean
  • Check if any agent bootstrap files need updating (template changes)
  • Report results to orchestrator

Config

Requires ecosystem.upstream_sync.enabled: true in config.json.

Safety

  • NEVER auto-merges
  • NEVER applies without explicit user approval
  • NEVER applies during night mode — check day_mode_start/day_mode_end from config.json before proceeding
  • Always explains changes before applying
  • Warns about breaking changes or template modifications

© grandamenium, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in community/skills/upstream-sync of grandamenium/cortextos.

Open the folder on GitHubat commit 6f93838

Compare with similar skills

Upstream Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Upstream Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Upstream Sync this skillgrandamenium/cortextos101—~501Automated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill4.2k—~4.1kAutomated safety check: PassMIT
Simple Issue Descriptionevery-app/open-seo23k1 repos~1.2kAutomated safety check: PassMIT
Ponytail AuditDietrichGebert/ponytail159k—~1.4kAutomated safety check: PassMIT
Technical Writing Standardcursor/plugins10k10 repos~2.4kAutomated safety check: PassNone
Natural Japanese Business Writingcoji/natural-japanese1.9k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    4.2k GitHub stars~4.1k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • Simple Issue Description

    every-app/open-seo

    Turn a rough bug report, feature request, support note, or pull request into a short, plain-language issue focused on the problem and desired behavior.

    23k GitHub starsUsed in 1 repo~1.2k tokens
    Writing & ContentAuto-check passed
  • Ponytail Audit

    DietrichGebert/ponytail

    Quality audit of a whole repo: bugs, security holes, what breaks under real load, risky code without tests, slow paths, and what to delete, merge or split.

    159k GitHub stars~1.4k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Official

    Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.

    10k GitHub starsUsed in 10 repos~2.4k tokens
    Writing & ContentAuto-check passed
  • Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.

    1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Pgjev

    realZachi/pg-jev

    Install, configure, query and explain pgjev (the jev PostgreSQL extension that filters, ranks and classifies rows with plain-language conditions via TypeSafe's Jev model).

    1.1k GitHub stars~2.9k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed

More from grandamenium/cortextos

All 55 skills in this repo
  • Cortext Self Diagnosis

    grandamenium/cortextos

    Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…

    101 GitHub stars~3.7k tokensUpdated 16 days ago
    Auto-check passed
  • Activity Channel

    grandamenium/cortextos

    You have completed something significant and want the whole org — all agents and the user — to know about it.

    101 GitHub stars~624 tokensUpdated 16 days ago
    Auto-check passed
  • Agentcard Purchase

    grandamenium/cortextos

    You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.

    101 GitHub stars~1.1k tokensUpdated 16 days ago
    Auto-check passed
  • Claude To Codex Migration

    grandamenium/cortextos

    Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.

    101 GitHub stars~12k tokensUpdated 16 days ago
    Auto-check: warnings
  • Bus Reference

    grandamenium/cortextos

    Complete cortextos bus CLI reference - all available commands with examples.

    101 GitHub stars~3.8k tokensUpdated 16 days ago
    Auto-check passed
  • Business News Monitor

    grandamenium/cortextos

    Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.

    101 GitHub stars~1.3k tokensUpdated 16 days ago
    Auto-check passed

Questions about Upstream Sync

What does Upstream Sync do?

Check for cortextOS framework updates from the remote repo. An agent skill from grandamenium/cortextos. Upstream Sync is an agent skill from grandamenium/cortextos. Check for cortextOS framework updates from the remote repo.

When should I use Upstream Sync?

Upstream Sync fits situations like: tasks that involve Plain language and style rules.

How do I install Upstream Sync in Claude Code?

Run `npx skills add grandamenium/cortextos --skill upstream-sync -a claude-code`. Or copy the skill folder (community/skills/upstream-sync in grandamenium/cortextos) into .claude/skills/upstream-sync in your project. Claude Code loads it when a task matches its description.

How do I install Upstream Sync in Codex?

Run `npx skills add grandamenium/cortextos --skill upstream-sync -a codex`. Or copy the skill folder (community/skills/upstream-sync in grandamenium/cortextos) into .agents/skills/upstream-sync in your project. Codex loads it when a task matches its description.

Can I use Upstream Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add grandamenium/cortextos --skill upstream-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/upstream-sync, .gemini/skills/upstream-sync, .github/skills/upstream-sync and .opencode/skills/upstream-sync in your project.

What does Upstream Sync need to run?

Going by SKILL.md and its folder, Upstream Sync needs the command-line tools its instructions call (git).

Does Upstream Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Upstream Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Upstream Sync use?

Upstream Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Upstream Sync use?

About 501 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Upstream Sync?

Skills that share tags, products or a category with Upstream Sync: Asd Ste100 (danyuchn/asd-ste100-skill, 4.2k stars), Simple Issue Description (every-app/open-seo, 23k stars), Ponytail Audit (DietrichGebert/ponytail, 159k stars) and Technical Writing Standard (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Upstream Sync?

grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.

Source: grandamenium/cortextos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.