New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Cy Spec Preflight

by compozy in compozy/compozy

Check a Compozy spec or task artifact during authoring or when its contracts change.

MITAuto-check passed

Install Cy Spec Preflight

skills CLI
$ npx skills add compozy/compozy --skill cy-spec-preflight -a claude-code

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

GitHub CLI
$ gh skill install compozy/compozy cy-spec-preflight --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/.agents/skills/cy-spec-preflight .claude/skills/cy-spec-preflight && 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-spec-preflight
GitHub stars
2.8k
Token cost
~324 tokens
SKILL.md length
144 words
Files
8 (incl. scripts, references)
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Check a Compozy spec or task artifact during authoring or when its contracts change.

  • Runs Python scripts from its folder

What it does

Cy Spec Preflight is an agent skill from compozy/compozy. Check a Compozy spec or task artifact during authoring or when its contracts change.

Its SKILL.md is about 320 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/phase-lessons.md`, `references/spec-contracts.md` and `references/spec-part1-checks.md`).

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.

Example prompts

  • “/cy-spec-preflight”

Requirements

  • Python 3

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

    Ships 2 files in scripts/ (Python), which the agent can run.

    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 Spec Preflight loads about 324 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 144 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from compozy/compozy at commit eec2ed1, republished under its MIT licence (© compozy). 144 words, ~324 tokens.

Download SKILL.mdSave it as .claude/skills/cy-spec-preflight/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
cy-spec-preflight
description
Check a Compozy spec or task artifact during authoring or when its contracts change.

Spec Preflight

Check the current artifact within its authoring/change step. Reuse accepted research, decisions, and prior checks; execution of an unchanged task does not require another preflight or repository survey.

Choose only the relevant branch:

  • Spec: Spec contracts for outcome, interfaces, compatibility, and applicable companion contracts. Use the playbook only for an unresolved authoring convention and references/phase-lessons.md when a matching design question needs historical evidence.
  • Tasks/task body: Task checks for graph consistency, outcome coverage, canonical references, test/evidence ownership, and QA scope.

Repair substantive contract or dependency gaps at their owner, then check the changed facts. User decisions and repository compatibility policy outrank stale artifacts; an ADR cannot silently narrow the accepted outcome. Missing template phrases, empty optional sections, or an unused companion document are not blockers. Ask only when a missing product decision prevents correct authoring. Peer review of an approved spec remains opt-in.

© 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 7 other files (scripts, references) in .agents/skills/cy-spec-preflight of compozy/compozy.

  • SKILL.md
  • references/phase-lessons.md
  • references/spec-contracts.md
  • references/spec-part1-checks.md
  • references/spec-six-markers.md
  • references/tasks-checks.md
  • scripts/check-spec-markers.py
  • scripts/check-spec-part1-leak.py

Open the folder on GitHubat commit eec2ed1

Compare with similar skills

Cy Spec Preflight 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 Spec Preflight compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cy Spec Preflight this skillcompozy/compozy2.8k—~324Automated safety check: PassMIT
Artifacts Buildernexu-io/open-design100k—~347Automated safety check: PassApache-2.0
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0
Web Artifacts Buildernexu-io/open-design100k—~337Automated safety check: PassApache-2.0

Similar skills

  • Artifacts Builder

    nexu-io/open-design

    Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui).

    100k GitHub stars~347 tokensUpdated today
    Frontend & DesignAuto-check passed

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed

  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

  • Web Artifacts Builder

    nexu-io/open-design

    Build complex claude.ai HTML artifacts with React and Tailwind.

    100k GitHub stars~337 tokensUpdated today
    Frontend & DesignAuto-check passed

  • Authoring Skills

    vercel/next.js

    Official

    How to create and maintain agent skills in .agents/skills/. An agent skill from vercel/next.js.

    143k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-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

  • Assistant UI Primitives

    compozy/compozy

    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 Spec Preflight

What does Cy Spec Preflight do?

Check a Compozy spec or task artifact during authoring or when its contracts change. Cy Spec Preflight is an agent skill from compozy/compozy. Check a Compozy spec or task artifact during authoring or when its contracts change.

How do I install Cy Spec Preflight in Claude Code?

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

How do I install Cy Spec Preflight in Codex?

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

Can I use Cy Spec Preflight 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-spec-preflight -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-spec-preflight, .gemini/skills/cy-spec-preflight, .github/skills/cy-spec-preflight and .opencode/skills/cy-spec-preflight in your project.

What does Cy Spec Preflight need to run?

Going by SKILL.md and its folder, Cy Spec Preflight needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Cy Spec Preflight 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 Spec Preflight 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Cy Spec Preflight use?

Cy Spec Preflight 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 Spec Preflight use?

About 324 tokens (SKILL.md is roughly 1.3k 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 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Cy Spec Preflight?

Skills that share tags, products or a category with Cy Spec Preflight: Artifacts Builder (nexu-io/open-design, 100k stars), Web Artifacts Builder (anthropics/skills, 180k stars), Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars) and Configuring Oauth2 Authorization Flow (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cy Spec Preflight?

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.