daocloud-skills

A generated CLI and AI skill package for DaoCloud Enterprise (DCE). It wraps the DCE REST API into a dce command-line tool and bundles a companion skill for AI agents.

Overview

• dce — a CLI generated from DCE OpenAPI specs (global-management, container-management). Supports API discovery, search, and execution with built-in auth management.
• skills/dce — an AI agent skill that teaches agents how to use dce safely.

Currently supported products:

| Module | Description | |---|---| | global-management | Global Management — users, groups, workspaces, roles, audit | | container-management | Container Management — clusters, namespaces, workloads, storage | | insight | Insight — observability, metrics, alerting, and related operations |

Prerequisites

• Go 1.25+
• Git (for spec sync)
• Docker with buildx (for container image builds)

Quick Start

# Sync OpenAPI specs and regenerate code
make bootstrap

# Build dce
make build

# Install dce and symlink skill for local development
make dev

The make dev target installs dce to /usr/local/bin and symlinks skills/dce into ~/.agents/skills/dce for live local development in an AI agent runtime.

Install the Skill

Install the dce skill globally:

npx skills add daocloud/daocloud-skills -g

For non-interactive installs, add confirmation flags:

npx -y skills add daocloud/daocloud-skills -g -y

The -g flag installs the skill into the selected agent's user-level skills directory, so it is available across projects. Omit -g if you want to install the skill only for the current project.

This installs the skill only. The skill helps an AI agent use dce, but it does not install the dce CLI. Install the CLI separately before running DCE operations.

Install for a Specific Agent

Use --agent to install the dce skill for a specific AI coding agent. Common client targets include:

Claude Code

npx skills add daocloud/daocloud-skills -g --skill dce --agent claude-code

Codex

npx skills add daocloud/daocloud-skills -g --skill dce --agent codex

Cursor

npx skills add daocloud/daocloud-skills -g --skill dce --agent cursor

Use --agent more than once to install the same skill into multiple agents:

npx skills add daocloud/daocloud-skills -g \
  --skill dce \
  --agent claude-code \
  --agent codex \
  --agent cursor

This installs the skill from the repository's default branch. To inspect available skills before installing:

npx skills add daocloud/daocloud-skills --list

To uninstall the global dce skill, use remove with the same agent target:

npx skills remove -g dce --agent codex

After installation, open a new agent session and ask it to use the dce skill for DCE operations, for example:

Use the dce skill to list DCE clusters.

Install the CLI

The recommended way is via npm:

npm install -g @daocloud-cli/dce

Or run on demand without a global install:

npx @daocloud-cli/dce --help

The npm package downloads the matching prebuilt binary from GitHub Releases on install and verifies it against checksums.txt. Supported platforms: darwin/linux on amd64/arm64, Node.js >= 16.

Alternatively, download a prebuilt archive from GitHub Releases directly:

VERSION=v0.1.0-rc.6
OS=darwin
ARCH=amd64
PKG="dce-${VERSION}-${OS}-${ARCH}"

curl -fL "https://github.com/DaoCloud/daocloud-skills/releases/download/${VERSION}/${PKG}.tar.gz" -o dce.tar.gz
tar -xzf dce.tar.gz
sudo install -m 0755 "${PKG}/dce" /usr/local/bin/dce

Use OS=darwin for macOS and OS=linux for Linux. Use ARCH=arm64 for Apple Silicon or ARM64 Linux, and ARCH=amd64 for Intel macOS or x86_64 Linux.

Verify the CLI is available:

dce --help

For source builds from this repository:

make build
sudo cp bin/dce /usr/local/bin/dce

For local development, use make dev to build the CLI, copy it to /usr/local/bin/dce, and symlink the local skill directory:

make dev

Usage

# Log in to a DCE instance
dce auth login --hostname https://<dce-host>

# Browse available commands
dce commands --json

# Search for a command by intent
dce search "list clusters" --json

# Inspect a command before executing
dce commands show container-management cluster list-clusters --json

# Execute a command
dce container-management cluster list-clusters -o json

Container Image

The image bundles the dce binary and the skills/dce directory under /app/, intended for use as a Kubernetes init container to distribute the tooling into a shared volume.

# Build multi-arch image locally
make image

# Build and push to registry
make image-push IMAGE_REPO=registry.example.com/dce IMAGE_TAG=v1.0.0

Default values: IMAGE_REPO=daocloud/dce, IMAGE_TAG=latest.

Init Container Example

initContainers:
  - name: install-dce
    image: daocloud/dce:latest
    command:
      - sh
      - -c
      - |
        cp /app/dce /target/bin/dce
        cp -r /app/skills/dce /target/.agents/skills/dce
    volumeMounts:
      - name: tools
        mountPath: /target

volumes:
  - name: tools
    emptyDir: {}

After the init container completes, the shared volume contains:

• /target/bin/dce — CLI binary
• /target/.agents/skills/dce/ — AI agent skill

Development

| Target | Description | |---|---| | make bootstrap | Sync specs + regenerate all code | | make specsync | Pull latest OpenAPI specs from upstream | | make codegen | Regenerate Go code and skill references from specs | | make sync-one SOURCE=<name> | Sync and regenerate a single source (e.g. ghippo) | | make build | Build bin/dce | | make image | Build multi-arch image locally (linux/amd64, linux/arm64) | | make image-push | Build and push multi-arch image to registry | | make dev | Build, install, and symlink skill for local debugging | | make dev-clean | Remove installed binary and skill symlink | | make clean | Remove .cache and bin |

Project Structure

.
├── cli.yaml                  # CLI name and auth config
├── specs/sources.yaml        # OpenAPI source definitions (pinned commits)
├── internal/
│   ├── generated/            # Generated Go command modules (do not edit)
│   └── overlay/              # Per-source field overrides for codegen
├── skills/dce/            # AI agent skill (SKILL.md + references)
├── docs/                     # Developer guides
├── cmd/dce/main.go        # CLI entrypoint
└── doc.go                    # Embeds cli.yaml for use by main

Guides

• Adding a new product — step-by-step guide for onboarding a new DCE product (spec source, overlay, codegen, verification)

How It Works

1. specsync clones the pinned commit of daocloud-api-docs and extracts the OpenAPI JSON files into .cache/specs-sync/.
2. codegen reads each spec, applies the overlay from internal/overlay/<source>.yaml, and emits:
   • Go cobra subcommands under internal/generated/<source>/
   • A command index at skills/dce/references/modules/<source>.md
   • An updated internal/generated/modules_gen.go that mounts all modules
3. go build compiles everything into a single static binary bin/dce.

Overlay files are the only place where human-maintained configuration lives — everything else is generated and should not be edited by hand.

Updating a Pinned Spec

Update the pinned_tag for the relevant source in specs/sources.yaml, then run:

make sync-one SOURCE=<name>