菜单
Manage infrastructure using cinc-client (FOSS Chef Infra Client). Use for: applying config, running recipes/roles, dry-run convergence, testing cookbooks, or debugging failures. Triggers on 'run cinc', 'converge', 'why-run', or 'cinc recipe'.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
AWS CLI (aws) for querying and managing AWS resources. Use for S3 operations (list buckets/objects, upload, download, sync, copy, delete), ad-hoc resource queries, and checking AWS resource state. Triggers on 'aws', 'S3', or any AWS service request.
Manage an AzuraCast web radio station via its REST API. Use for: checking what's playing, managing playlists/media, restarting the station, viewing listeners, reports, schedule, queue, podcasts, mounts, streamers, and full station administration.
Manage Cloudflare DNS records and R2 object storage via API. Use for adding/updating/deleting DNS records (A, AAAA, CNAME, MX, TXT), or managing R2 buckets, lifecycle, CORS, custom domains, notifications, lock rules, metrics, or Sippy migration.
Manage Hetzner Cloud resources using the hcloud CLI. Use for servers, volumes, snapshots, firewalls, networks, load balancers, SSH keys, and placement groups. Triggers on 'hcloud', 'Hetzner', or any Hetzner Cloud resource management task.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Manage 1Password vaults/secrets with the op CLI. Use for: reading secrets, secret references (op://), listing/creating/editing items, injecting secrets into configs, running commands with secret env vars, TOTP, documents. Triggers on '1Password'.
| name | cinc-client |
| description | Manage infrastructure using cinc-client (FOSS Chef Infra Client). Use for: applying config, running recipes/roles, dry-run convergence, testing cookbooks, or debugging failures. Triggers on 'run cinc', 'converge', 'why-run', or 'cinc recipe'. |
Cinc Client 18.6.2 at /bin/cinc-client. Config: /etc/cinc/client.rb. Chef server: https://spinoza.ekamai.net/organizations/ekamai. Local repo: /home/tcase/Sites/cinc/.
# Apply this node's run list from server
sudo cinc-client
# Local mode with node JSON (no server needed)
sudo cinc-client -z -j nodes/$(hostname).json
# Override run list for a single run
sudo cinc-client -z -o 'role[devmachine]'
sudo cinc-client -z -o 'recipe[base::packages]'
# Dry run (show changes without applying)
sudo cinc-client -z --why-run
sudo cinc-client --why-run # against server
| Flag | Purpose |
|---|---|
-z | Local mode (uses /home/tcase/Sites/cinc/) |
-j FILE | Load node attributes from JSON |
-o RUNLIST | Override run list for this run only |
-W / --why-run | Dry run |
-l debug | Debug logging |
--once | Run once, ignore interval/splay |
-E ENV | Set environment |
cd /home/tcase/Sites/cinc/cookbooks/<name>
kitchen list # show test suites/platforms
kitchen converge # apply recipes to test instance
kitchen verify # run InSpec tests
kitchen test # full cycle: provision+converge+verify+destroy
kitchen destroy # tear down test instances
kitchen login # SSH into test instance
rake version:bump:patch # 0.1.0 → 0.1.1
rake version:bump:minor # 0.1.0 → 0.2.0
rake version:bump:major # 0.1.0 → 1.0.0
chef install Policyfile.rb # resolve and install dependencies
chef update Policyfile.rb # update lock file
chef export Policyfile.rb # export for deployment
/home/tcase/Sites/cinc/
├── cookbooks/ base, common, devmachine, desktop, pihole, remote, repos, ruby, nodejs, taskwarrior
├── roles/ debian_derivative, devmachine, desktop, ekamai, local_essentials, pihole, …
├── nodes/ per-machine JSON (ella, jaco, socrates, airweave, coltrane, …)
└── data_bags/ users/, cronjobs/, ekamai/, vault/
See references/repo-patterns.md for cookbook internals, recipe patterns, data bag usage, and role composition.
# List nodes
knife node list
# Show node details
knife node show <nodename>
# Apply config to a new node in local mode
sudo cinc-client -z -j nodes/<hostname>.json
To add a new machine: create nodes/<hostname>.json with roles and attributes, then run the local-mode command above on that machine.
# Verbose output
sudo cinc-client -l debug 2>&1 | tee /tmp/cinc-debug.log
# Run single recipe for quick iteration
sudo cinc-client -z -o 'recipe[base::users]' -l debug
# Dry-run with debug for attribute inspection
sudo cinc-client -z -j nodes/$(hostname).json --why-run -l debug
When a run fails, identify the failing resource and its cookbook/recipe. Use -l debug to see full resource execution and template rendering output.