Agent skill

Cctop Setup

by st0012 in st0012/cctop

A skill your agent uses when cctop-hook command fails or is not found.

MITAuto-check passedMobile

Install Cctop Setup

skills CLI
$ npx skills add st0012/cctop --skill cctop-setup -a claude-code

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

GitHub CLI
$ gh skill install st0012/cctop cctop-setup --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/st0012/cctop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/cctop/skills/cctop-setup .claude/skills/cctop-setup && 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
cctop-setup
GitHub stars
154
Token cost
~335 tokens
SKILL.md length
125 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when cctop-hook command fails or is not found.

  • Works in 4 steps: Check if cctop.app is installed → Install cctop → Verify installation → …
  • Cctop-hook command fails
  • SKILL.md covers When to Use, Installation and After Installation
  • Calls brew

What it does

Cctop Setup is an agent skill from st0012/cctop. Use when cctop-hook command fails or is not found. Guides user to install the cctop menubar app.

Its SKILL.md is about 340 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 Mobile. It works with macOS. The repository describes itself as: A keyboard-first menubar app to monitor and jump between AI coding sessions — minimum setup required. The licence is MIT.

When your agent uses it

  • Cctop-hook command fails

Example prompts

  • “/cctop-setup”

Workflow steps

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

  1. Check if cctop.app is installed
  2. Install cctop
  3. Verify installation
  4. Launch the app

What it can do on your machine

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

    • brew

    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

Cctop Setup loads about 335 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 125 words of instructions outside code blocks.

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

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 st0012/cctop at commit 4ee2258, republished under its MIT licence (© st0012). 125 words, ~335 tokens.

Download SKILL.mdSave it as .claude/skills/cctop-setup/SKILL.md (or your agent's skills folder).
name
cctop-setup
description
Use when cctop-hook command fails or is not found. Guides user to install the cctop menubar app.

cctop Setup Skill

Helps install the cctop app required for session monitoring.

When to Use

Run installation guidance when:

  • Hook fails with "cctop-hook not found"
  • User asks to set up cctop monitoring
  • Session tracking is not working

Installation

Step 1: Check if cctop.app is installed
bash
ls /Applications/cctop.app/Contents/MacOS/cctop-hook 2>/dev/null || ls ~/Applications/cctop.app/Contents/MacOS/cctop-hook 2>/dev/null

If not found, the user needs to install cctop.app.

Step 2: Install cctop

Option A: Homebrew (recommended)

bash
brew install --cask st0012/cctop/cctop

Option B: Download from GitHub Download the latest release from https://github.com/st0012/cctop/releases/latest and move cctop.app to /Applications/.

Step 3: Verify installation
bash
/Applications/cctop.app/Contents/MacOS/cctop-hook --version
Step 4: Launch the app
bash
open /Applications/cctop.app

After Installation

The hooks registered by this plugin will now work. Session data will be written to ~/.cctop/sessions/ when Claude Code or Claude Desktop hooks fire.

The menubar app will show session status in the macOS menu bar.

© st0012, 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 plugins/cctop/skills/cctop-setup of st0012/cctop.

Open the folder on GitHubat commit 4ee2258

Compare with similar skills

Cctop Setup 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.

Cctop Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cctop Setup this skillst0012/cctop154—~335Automated safety check: PassMIT
Ip As LogoKartikLabhshetwar/better-shot2.4k1 repos~4.3kAutomated safety check: PassMIT
Hig Project Contextraintree-technology/hig-doctor1435 repos~1.2kAutomated safety check: PassMIT
Hig Components Contentraintree-technology/hig-doctor1435 repos~1.3kAutomated safety check: PassMIT
macOS CapabilitiesKartikLabhshetwar/better-shot2.4k2 repos~1.1kAutomated safety check: PassCustom licence
macOS Auto Updatefayazara/macos-app-skills675—~1.8kAutomated safety check: PassNone

Similar skills

  • Ip As Logo

    KartikLabhshetwar/better-shot

    Generate extremely simple, cute, personified square character images with rounded heavy forms, two purposeful character colors, one solid background color, and a dominant lower-corner composition.

    2.4k GitHub starsUsed in 1 repo~4.3k tokens
    MobileAuto-check passed
  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    143 GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Hig Components Content

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for content display components.

    143 GitHub starsUsed in 5 repos~1.3k tokens
    MobileAuto-check passed
  • macOS Capabilities

    KartikLabhshetwar/better-shot

    Expert guidance on macOS platform capabilities. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 2 repos~1.1k tokens
    MobileAuto-check passed
  • macOS Auto Update

    fayazara/macos-app-skills

    Add Sparkle auto-update support to a native macOS app. An agent skill from fayazara/macos-app-skills.

    675 GitHub stars~1.8k tokensUpdated 4 mo ago
    MobileAuto-check passed
  • API Exploration

    sozercan/kaset

    A skill your agent uses when a task needs a new or modified YouTube Music API call, response parser validation, authenticated endpoint investigation, or fixture capture; explore endpoints with swift…

    2.4k GitHub stars~454 tokensUpdated 4 days ago
    MobileAuto-check passed

More from st0012/cctop

  • E2E Session Test

    st0012/cctop

    A skill your agent uses when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel.

    154 GitHub stars~727 tokensUpdated 7 days ago
    Auto-check passed
  • Video Assets

    st0012/cctop

    A skill your agent uses when publishing, replacing, auditing, or linking cctop promo/demo video assets through GitHub Releases, especially the non-latest media-assets release.

    154 GitHub stars~1.4k tokensUpdated 7 days ago
    Auto-check passed
  • Release

    st0012/cctop

    A skill your agent uses when cutting or preparing a cctop release - "cut a release", "release vX.Y.Z", "prepare a release", "bump the version and tag", "ship a new version".

    154 GitHub stars~1.4k tokensUpdated 7 days ago
    Auto-check passed
  • Swiftui Debugging

    st0012/cctop

    A skill your agent uses when debugging SwiftUI issues in this macOS app — views not updating, layout problems, unnecessary re-renders, state ownership bugs, Preview crashes, or NSHostingView/NSPanel…

    154 GitHub stars~2k tokensUpdated 7 days ago
    Auto-check passed
  • Video Storyboard

    st0012/cctop

    A skill your agent uses when designing, scripting, or storyboarding a short demo, launch, explainer, or marketing video (especially for a developer tool, app, or SaaS), OR when auditing, critiquing…

    154 GitHub stars~3.4k tokensUpdated 7 days ago
    Auto-check passed
  • Cctop Restart

    st0012/cctop

    Restart cctop for local development and testing. An agent skill from st0012/cctop.

    154 GitHub stars~395 tokensUpdated 7 days ago
    Auto-check passed

Works with

Categories

Questions about Cctop Setup

What does Cctop Setup do?

A skill your agent uses when cctop-hook command fails or is not found. Cctop Setup is an agent skill from st0012/cctop. Use when cctop-hook command fails or is not found.

When should I use Cctop Setup?

Cctop Setup fits situations like: cctop-hook command fails.

How do I install Cctop Setup in Claude Code?

Run `npx skills add st0012/cctop --skill cctop-setup -a claude-code`. Or copy the skill folder (plugins/cctop/skills/cctop-setup in st0012/cctop) into .claude/skills/cctop-setup in your project. Claude Code loads it when a task matches its description.

How do I install Cctop Setup in Codex?

Run `npx skills add st0012/cctop --skill cctop-setup -a codex`. Or copy the skill folder (plugins/cctop/skills/cctop-setup in st0012/cctop) into .agents/skills/cctop-setup in your project. Codex loads it when a task matches its description.

Can I use Cctop Setup 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 st0012/cctop --skill cctop-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cctop-setup, .gemini/skills/cctop-setup, .github/skills/cctop-setup and .opencode/skills/cctop-setup in your project.

What does Cctop Setup need to run?

Going by SKILL.md and its folder, Cctop Setup needs the command-line tools its instructions call (brew).

Does Cctop Setup 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 Cctop Setup 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 Cctop Setup use?

Cctop Setup 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 Cctop Setup use?

About 335 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.

What are the alternatives to Cctop Setup?

Skills that share tags, products or a category with Cctop Setup: Ip As Logo (KartikLabhshetwar/better-shot, 2.4k stars), Hig Project Context (raintree-technology/hig-doctor, 143 stars), Hig Components Content (raintree-technology/hig-doctor, 143 stars) and macOS Capabilities (KartikLabhshetwar/better-shot, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cctop Setup?

st0012 (a GitHub user) maintains it in st0012/cctop, which has 154 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 1, 2026.

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