Skip to content
cccskills
FreePublished on GitHub

coding-agent-rollout

Review a team's Claude Code permissions, approved integrations, and layered instruction files. Included scripts check configuration issues and summarize adoption using counts, so team members can share usage data without sharing conversation transcripts.

OriginalShow the original description

Use when rolling Claude Code out to a team or organization, or auditing a rollout already under way — writing or reviewing shared and managed settings.json permissions, deciding which MCP servers, plugins and marketplaces to approve, cleaning up layered CLAUDE.md files, or measuring whether the team actually uses it. Lints settings across scopes, inventories every MCP server and plugin against an approved list, resolves CLAUDE.md layers and imports, and turns local session data into privacy-safe adoption counts.

See how to install

Good for

  • Review permissions before a team rollout
  • Check integrations against an approved list
  • Find conflicting instruction files
  • Measure adoption without sharing transcripts

Files included (11)

  • SKILL.md5.3 KB
  • assets/approved-components.example.json249 B
  • assets/managed-settings.example.json865 B
  • assets/rollout_plan.md2.0 KB
  • references/mcp_and_plugin_governance.md4.2 KB
  • references/memory_and_adoption.md5.0 KB
  • references/settings_and_permissions.md6.0 KB
  • scripts/adoption_tracker.py11.7 KB
  • scripts/claude_md_layering_audit.py11.9 KB
  • scripts/mcp_plugin_inventory.py10.2 KB
  • scripts/settings_linter.py15.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Claude Code Team Rollout

Portability: 4 stdlib scripts, no network, no LLM calls. They read config and counts; they change nothing.

One engineer's Claude Code setup is a preference. A team's is a policy. Settings merge from five scopes, permissions.allow arrays combine across files, and deny beats ask beats allow wherever it is written, so nobody can read the effective policy from a single file. This skill makes it readable, then checks it.

Workflow

# 1 - Guardrails: lint shared, local and managed settings together.
python scripts/settings_linter.py --repo . --managed /etc/claude-code/managed-settings.json
# 2 - Inventory: every MCP server, plugin and marketplace, against your approved list.
python scripts/mcp_plugin_inventory.py --repo . --allowlist approved.json
# 3 - Instructions: what CLAUDE.md actually loads, layer by layer.
python scripts/claude_md_layering_audit.py --repo .
# 4 - Adoption: each member runs this locally and shares only the JSON counts.
python scripts/adoption_tracker.py --member alice --output json > alice.json
python scripts/adoption_tracker.py --merge *.json --seats 12 --weeks-since-launch 6

Start from assets/managed-settings.example.json: bypass mode disabled, secrets denied, risky commands on ask, managed hooks only, an MCP and marketplace allowlist. Ship it through MDM before the first seat; policy added after habits form becomes a negotiation.

What blocks (exit 4)

  • Blanket shell allows (Bash, Bash(*)) and pre-approved destructive commands (force push, rm -rf, sudo, pipe-to-shell, publish, infra apply).
  • A literal credential in a shared settings env block, a committed .mcp.json, or a committed CLAUDE.md.
  • .claude/settings.local.json committed to git.
  • An MCP server, plugin or marketplace missing from the approved list.

Warnings cover dead rules (an allow that a deny shadows, mcp__* in allow), enableAllProjectMcpServers, unpinned npx servers, plain-http remotes, network-calling hooks, broken or too-deep @imports, duplicated or contradictory instructions, and resident CLAUDE.md size.

Hard rules

  1. Policy lives in managed settings. Project files cannot enable bypass mode or telemetry, and a team guardrail in a file anyone can edit is a suggestion.
  2. Approve MCP servers by name, URL or command, never by enableAllProjectMcpServers.
  3. Pin what runs. Unpinned npx/uvx servers and unpinned marketplaces change under you.
  4. Never collect transcripts. Share the adoption JSON (counts only); transcripts are plaintext and can hold secrets.
  5. Report findings, not verdicts on people. Adoption is a team metric; inactive seats are a rollout question, not a performance one.
  6. Settings keys change fast. An unknown key is INFO; check the settings reference before calling it a typo.

Scripts

ScriptRoleExit codes
scripts/settings_linter.pyS1-S12 across shared, local, user and managed scopes0 · 2 warn · 3 bad input · 4 blocker
scripts/mcp_plugin_inventory.pyOne table of servers, plugins, marketplaces; M1-M60 · 2 · 3 · 4
scripts/claude_md_layering_audit.pyResident vs on-demand layers, imports (4 hops), L1-L110 · 2 · 3 · 4
scripts/adoption_tracker.pyMember counts; team stage PILOT / SPREADING / EMBEDDED / STALLED0 · 2 stalled · 3

All support --sample and --output json.

References and assets

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a11y-audit

FreeSummary

Audit web applications for accessibility issues against WCAG 2.2 Level A and AA, the web accessibility standards. Get framework-specific code fixes, contrast checks, verification steps, and reports, with options for automated checks in development pipelines.

  • Audit a web application before release
  • Fix contrast and keyboard navigation issues
  • Prepare accessibility reports for stakeholders
alirezarezvani/claude-skills28.5KUpdated Oct 21, 2026

ab-test-setup

FreeSummary

Plan A/B tests that compare page variations, from headlines to pricing layouts. Define a hypothesis, choose success metrics, calculate sample size and duration, and prepare launch checks and results reports to support decisions.

  • Comparing landing page headlines
  • Testing signup button changes
  • Planning pricing page experiments
alirezarezvani/claude-skills28.5KUpdated Oct 21, 2026

ad-creative

FreeSummary

Create paid ad headlines and body copy tailored to each platform's character limits. Use existing performance data to develop variations, explore new messaging angles, and check copy for length, quality, and potential rejection risks.

  • Creating Google RSA headlines
  • Writing Meta and LinkedIn ad copy
  • Developing variations of successful ads
alirezarezvani/claude-skills28.5KUpdated Oct 21, 2026

Review code changes from three critical perspectives: production failures, maintainability, and security. Get a consolidated report that ranks findings by severity and provides merge guidance, helping examine assumptions that an ordinary self-review may overlook.

  • Reviewing a pull request before merging
  • Getting a second opinion on AI-written code
  • Checking authentication or data access code
alirezarezvani/claude-skills28.5KUpdated Oct 21, 2026

aeo

FreeSummary

Audit and improve content intended for citation in AI answers. Review evidence, author information, and structure, generate revised content and structured metadata, and keep a local record of observed citations across AI services.

  • Audit existing articles for evidence and credibility gaps
  • Revise article structure and references for AI answers
  • Record citations observed across AI services
alirezarezvani/claude-skills28.5KUpdated Oct 21, 2026

Create signed records for consequential agent actions such as deployments, deletions, and payments. Decide which actions need evidence, record the agent, action, target, and policy, then verify the resulting certificate offline to detect later changes.

  • Creating signed records for production deployments
  • Preserving evidence of deletions and payments
  • Recording access grants for later review
alirezarezvani/claude-skills28.5KUpdated Oct 21, 2026

See all skills by alirezarezvani

Report a problem with this skill