sco-control

SCO Control Skill

Skill for operating SenseCore SCO CLI workflows with a compact, layered command guide. Supports both Claude Code (plugin) and Codex (manual copy).

The skill focuses on high-frequency SCO operations:

• ACP training job submit, inspect, logs, worker lookup, and quota selection
• CCI app listing, describing, and YAML creation patterns
• AEC2 cluster/spec queries
• AFS volume, directory, quota, and ACL management
• CCR/AOSS-style container image listing, build, namespace, and label workflows

The bundled references are intentionally small. They capture practical command patterns and known local CLI behavior without vendoring the full SCO documentation.

Installation

Claude Code (Plugin)

Register the marketplace and install:

claude plugins:add-marketplace https://github.com/BinaryCheater/sco-skill.git --name sco-skill
claude plugins:install sco-control

Or manually:

git clone https://github.com/BinaryCheater/sco-skill.git /tmp/sco-skill
mkdir -p ~/.claude/plugins/cache/sco-skill/sco-control/1.0.0
cp -R /tmp/sco-skill/.claude-plugin ~/.claude/plugins/cache/sco-skill/sco-control/1.0.0/
cp -R /tmp/sco-skill/skills ~/.claude/plugins/cache/sco-skill/sco-control/1.0.0/
cp /tmp/sco-skill/package.json ~/.claude/plugins/cache/sco-skill/sco-control/1.0.0/

Then add to ~/.claude/plugins/installed_plugins.json:

"sco-control@sco-skill": [
  {
    "scope": "user",
    "installPath": "/root/.claude/plugins/cache/sco-skill/sco-control/1.0.0",
    "version": "1.0.0",
    "installedAt": "2026-05-17T00:00:00.000Z",
    "lastUpdated": "2026-05-17T00:00:00.000Z"
  }
]

Restart Claude Code to load the plugin.

Codex (Manual Copy)

mkdir -p ~/.codex/skills
cp -R skills/sco-control ~/.codex/skills/sco-control

Symlink for local development:

mkdir -p ~/.codex/skills
ln -s "$(pwd)/skills/sco-control" ~/.codex/skills/sco-control

Restart Codex or reload skills if your client requires it.

Prerequisites

• sco CLI installed and authenticated in your environment

Usage

Once installed, invoke the skill:

Use sco-control to list my CCI apps and inspect my ACP jobs.

For read-only discovery, prefer:

sco config list
sco acp jobs list --workspace-name "$WORKSPACE" --page-size 20 -o table
sco cci apps list --workspace-name "$WORKSPACE" --keyword "$USER_ID" --page-size 20
sco afs volume list
sco ccr images list

For ACP quota selection:

--quota-type reserved  # standard/reserved quota, default
--quota-type spot      # idle/preemptible quota

For CCI, --keyword fuzzy-matches user_name, display_name, and name, so use runtime user ids or app naming patterns as query values.

Repository Layout

.claude-plugin/
├── marketplace.json
└── plugin.json
package.json
skills/
└── sco-control/
    ├── SKILL.md
    ├── agents/openai.yaml
    └── references/
        ├── acp.md
        ├── acp_submit_template.sh
        ├── aec2-afs.md
        ├── cci.md
        ├── images.md
        └── run_sco_pattern.md

Safety

The skill treats list/describe/log operations as the default. Mutating operations such as create, update, delete, start, stop, quota changes, ACL changes, and image builds should be run only after explicit user intent.

The included acp_submit_template.sh is a sanitized reference template; it intentionally uses environment variables for workspace, cluster, storage, image, and project path values.

License

MIT