Agent skill

Cy Workflow Memory

by compozy in compozy/compozy

Maintains workflow-scoped task memory for CompozyOS runs using .compozy/tasks/<name/memory/ files.

MITAuto-check passedWriting & Content

Install Cy Workflow Memory

skills CLI
$ npx skills add compozy/compozy --skill cy-workflow-memory -a claude-code

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

GitHub CLI
$ gh skill install compozy/compozy cy-workflow-memory --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/compozy/compozy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/extensions/spec-cycle/skills/cy-workflow-memory .claude/skills/cy-workflow-memory && 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
cy-workflow-memory
GitHub stars
2.8k
Token cost
~385 tokens
SKILL.md length
163 words
Files
2 (incl. references)
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Maintains workflow-scoped task memory for CompozyOS runs using .compozy/tasks/<name/memory/ files.

  • A task prompt provides workflow memory paths and requires the agent to read
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Promote durable context across spec task executions
  • PR review remediation

What it does

Cy Workflow Memory is an agent skill from compozy/compozy. Maintains workflow-scoped task memory for CompozyOS runs using .compozy/tasks/<name/memory/ files. Use when a task prompt provides workflow memory paths and requires the agent to read, update, compact, and promote durable context across spec task executions. Do not use for PR review remediation, global user preferences, or programmatic event-log summarization.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/memory-guidelines.md`).

It sits in Writing & Content, covering Pull requests and Summarization. The repository describes itself as: An operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each… The licence is MIT.

When your agent uses it

  • A task prompt provides workflow memory paths and requires the agent to read
  • Promote durable context across spec task executions
  • PR review remediation
  • Global user preferences

Example prompts

  • “Use the cy-workflow-memory skill to maintain workflow-scoped task memory for CompozyOS runs using .compozy/tasks/<name/memory/ files”
  • “/cy-workflow-memory”

What it can do on your machine

Read from SKILL.md and the folder at commit eec2ed1. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Cy Workflow Memory loads about 385 tokens when it runs, and up to ~899 if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 163 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~385
With references · SKILL.md plus every file in references/, read only if the agent opens them
~899

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 compozy/compozy at commit eec2ed1, republished under its MIT licence (© compozy). 163 words, ~385 tokens.

Download SKILL.mdSave it as .claude/skills/cy-workflow-memory/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
cy-workflow-memory
description
Maintains workflow-scoped task memory for CompozyOS runs using .compozy/tasks/<name>/memory/ files. Use when a task prompt provides workflow memory paths and requires the agent to read, update, compact, and promote durable context across spec task executions. Do not use for PR review remediation, global user preferences, or programmatic event-log summarization.

Workflow Memory

Use the caller-provided shared/current-task memory paths for a continuing workflow. Read them on entry or after lost context; reuse them while current and do not scan unrelated task memories.

Update only when the goal, meaningful decision, blocker, or handoff evidence changes. A new message, status report, or commit alone does not require a rewrite. Keep task-local details in the task file and promote only durable facts another task needs that are not already clear from the spec or repository.

For compaction, preserve current state, decisions, risks, and handoff pointers; remove stale/repeated notes and transcripts. Read references/memory-guidelines.md only when its format or promotion rules are needed. Existing schema headings remain when the caller depends on them.

If a supplied path is missing, inspect the caller's documented initialization contract before reporting a concrete blocker; never guess another workflow's path. Repository contracts and current user decisions override stale notes. A short task without a supplied continuity requirement does not need a new memory subsystem.

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

Files

SKILL.md and 1 other file (references) in extensions/spec-cycle/skills/cy-workflow-memory of compozy/compozy.

  • SKILL.md
  • references/memory-guidelines.md

Open the folder on GitHubat commit eec2ed1

Compare with similar skills

Cy Workflow Memory 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.

Cy Workflow Memory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cy Workflow Memory this skillcompozy/compozy2.8k—~385Automated safety check: PassMIT
Contextpilot SavingsEfficientContext/ContextPilot140—~1.4kAutomated safety check: PassMIT
Simple Issue Descriptionevery-app/open-seo23k1 repos~1.2kAutomated safety check: PassMIT
Technical Writing Standardcursor/plugins10k10 repos~2.4kAutomated safety check: PassNone
Docs Reader Reviewprisma/web1.1k—~2.4kAutomated safety check: PassNone
Open PRKiln-AI/Kiln5.2k—~6.1kAutomated safety check: PassCustom licence

Similar skills

  • Contextpilot Savings

    EfficientContext/ContextPilot

    A skill your agent uses when a user asks how many tokens (or how much context/cost) ContextPilot has saved, or wants a ContextPilot savings status/summary inside Hermes Agent — e.g.

    140 GitHub stars~1.4k tokensUpdated 5 days ago
    AI & LLM EngineeringAuto-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
  • 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
  • Official

    A skill your agent uses when a docs page or section has been written or rewritten and is about to be handed over, when the operator says "reader review", "does this read like a human wrote it", "too…

    1.1k GitHub stars~2.4k tokensUpdated today
    Writing & ContentAuto-check passed
  • Open PR

    Kiln-AI/Kiln

    Open a pull request on the Kiln repo for a human to complete.

    5.2k GitHub stars~6.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Public Relations

    Cesarjoquin/Marketing-Skills

    When the user wants help with public relations, earned media, press coverage, journalist outreach, or media strategy (not pull requests).

    200 GitHub stars~1.8k tokensUpdated 24 days ago
    Writing & ContentAuto-check passed

More from compozy/compozy

All 47 skills in this repo
  • Eng Real Scenario QA

    compozy/compozy

    Dogfoods Compozy through an autonomous startup scenario with live providers, cross-surface observation, and strict evidence audit.

    2.8k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Eng Test Conventions

    compozy/compozy

    Go test-shape discipline for Compozy. An agent skill from compozy/compozy.

    2.8k GitHub stars~467 tokensUpdated today
    Auto-check passed
  • Assistant UI

    compozy/compozy

    Guide for assistant-ui library - AI chat UI components. An agent skill from compozy/compozy.

    2.8k GitHub stars~958 tokensUpdated today
    Auto-check passed
  • Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive.

    2.8k GitHub stars~999 tokensUpdated today
    Auto-check passed
  • Assistant UI Runtime

    compozy/compozy

    Guide for assistant-ui runtime system and state management. An agent skill from compozy/compozy.

    2.8k GitHub stars~856 tokensUpdated today
    Auto-check passed
  • Assistant UI Streaming

    compozy/compozy

    Guide for assistant-stream package and streaming protocols. An agent skill from compozy/compozy.

    2.8k GitHub stars~813 tokensUpdated today
    Auto-check passed

Questions about Cy Workflow Memory

What does Cy Workflow Memory do?

Maintains workflow-scoped task memory for CompozyOS runs using .compozy/tasks/<name/memory/ files. Cy Workflow Memory is an agent skill from compozy/compozy.compozy/tasks/<name/memory/ files.

When should I use Cy Workflow Memory?

Cy Workflow Memory fits situations like: A task prompt provides workflow memory paths and requires the agent to read; promote durable context across spec task executions; PR review remediation; global user preferences.

How do I install Cy Workflow Memory in Claude Code?

Run `npx skills add compozy/compozy --skill cy-workflow-memory -a claude-code`. Or copy the skill folder (extensions/spec-cycle/skills/cy-workflow-memory in compozy/compozy) into .claude/skills/cy-workflow-memory in your project. Claude Code loads it when a task matches its description.

How do I install Cy Workflow Memory in Codex?

Run `npx skills add compozy/compozy --skill cy-workflow-memory -a codex`. Or copy the skill folder (extensions/spec-cycle/skills/cy-workflow-memory in compozy/compozy) into .agents/skills/cy-workflow-memory in your project. Codex loads it when a task matches its description.

Can I use Cy Workflow Memory 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 compozy/compozy --skill cy-workflow-memory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cy-workflow-memory, .gemini/skills/cy-workflow-memory, .github/skills/cy-workflow-memory and .opencode/skills/cy-workflow-memory in your project.

What does Cy Workflow Memory need to run?

SKILL.md names no scripts, command-line tools or credentials: Cy Workflow Memory is instructions for the agent only.

Does Cy Workflow Memory access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cy Workflow Memory 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 Cy Workflow Memory use?

Cy Workflow Memory 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 Cy Workflow Memory use?

About 385 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 514 tokens, read only when the agent opens those files.

What are the alternatives to Cy Workflow Memory?

Skills that share tags, products or a category with Cy Workflow Memory: Contextpilot Savings (EfficientContext/ContextPilot, 140 stars), Simple Issue Description (every-app/open-seo, 23k stars), Technical Writing Standard (cursor/plugins, 10k stars) and Docs Reader Review (prisma/web, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cy Workflow Memory?

compozy (a GitHub organization) maintains it in compozy/compozy, which has 2,792 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

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