Skip to content

Add /claude-code-for-teams, the rollout page for the team question - #156

Merged
TommyBez merged 2 commits into
mainfrom
gtm/claude-code-for-teams
Aug 24, 2026
Merged

Add /claude-code-for-teams, the rollout page for the team question#156
TommyBez merged 2 commits into
mainfrom
gtm/claude-code-for-teams

Conversation

@TommyBez

@TommyBez TommyBez commented Aug 24, 2026

Copy link
Copy Markdown
Owner

Hypothesis

A lead or an admin searching "claude code for teams" already has Claude Code working for one person. They want to know what changes for ten: which plan carries the admin features, where configuration lives, what a teammate gets from a clone, and what they have to install by hand. Anthropic answers all of that, across about a dozen pages, and almost none of it is on the page that ranks for the phrase.

This page collects those answers in the order a rollout hits them, and it is the natural place for Skills Board to appear: the vendor mechanisms solve distribution, and the documentation says outright that the catalog of what is approved is left to each organisation.

Target from the phase 2 keyword pack: "claude code for teams" (210/month, KD 21), with "claude code enterprise" (880, KD 35), "skill library" (480, KD 0) and "skill sharing" (110, KD 0) as secondaries. Raw sum 1,680, realistic 300 to 400.

What is on the page

Seven tables, each one a question a rollout has to answer:

  1. Plans: the per-plan admin matrix. Server-managed settings, the analytics dashboard, SSO and Code Review exist on Team and Enterprise and not on Pro or Max; computer use runs the other way.
  2. Settings: the five layers in precedence order, with the four managed delivery mechanisms and their file paths.
  3. Conventions: the CLAUDE.md scopes, the claudeMd key, claudeMdExcludes, and the enforcement versus guidance line Anthropic draws itself.
  4. Skills: the four documented locations plus nested directories, --add-dir, and claude.ai sync.
  5. Plugins: extraKnownMarketplaces, enabledPlugins, the plugin seed directory, and the four managed lockdown keys.
  6. MCP: the three developer scopes, the plugin and connector layers, and managed MCP.
  7. Trust: Anthropic's own table of what a repository supplies before the folder itself is trusted.

Then a seven step rollout with a copyable team .claude/settings.json, the selection half that has no setting, six declared gaps, and seven FAQ entries.

Honest findings, in the page rather than smoothed over

  • The enterprise skills location has no published path. The skills page lists Enterprise as a location and points at managed settings; the managed settings page documents managed-settings.json, managed-settings.d/ and managed-mcp.json and never names a skills folder; the settings reference calls it "the managed policy directory" without saying where that is.
  • Skill precedence runs the opposite way from settings precedence. Skills: enterprise over personal over project, so a developer's own deploy skill beats the one the team committed. Settings: project local and shared project both sit above user. Both are documented clearly and no page reconciles them.
  • The plan matrix has no column for seat type. The feature availability matrix has Pro, Max, Team and Enterprise columns; the help center article adds that older Enterprise plans need a Chat + Claude Code or Premium seat. A row marked available for Enterprise can still be unavailable to a given person.
  • Anthropic states the registry gap itself. The managed MCP page says Claude Code has no built-in MCP server registry users can browse and install from, and suggests publishing the approved list on an internal wiki. The skills documentation has no equivalent registry either.
  • Locking the skills surface turns off the committed project skills too. strictPluginOnlyCustomization with skills in the list stops loading .claude/skills, which is the exact opposite of the commit-it-to-the-repository advice on the skills page. Both are published as good practice.
  • Sourcing note: docs.claude.com/en/docs/claude-code/* now redirects to code.claude.com/docs/en/*. The page cites the destination.

Sixteen first-party sources, all read on 2026-08-24: fifteen code.claude.com pages and one Anthropic help center article dated June 11, 2026. Every source is cited by at least one section and every section cites at least one source, both enforced by tests.

Differentiation

  • /manage-ai-skills keeps the cross-vendor organisation view; this page drills into the Claude Code column.
  • /claude-skills keeps the format; this page keeps the rollout.
  • /agent-skills-support keeps the client matrix.
  • /guides/how-to-write-a-skill-md keeps the authoring rules and this page links to it rather than repeating them.

Two contextual inbound links added, from /claude-skills and /manage-ai-skills. No link from the homepage.

Checks

  • 495 unit tests, of which 19 new, all green (node --test tests/*.test.mjs).
  • tsc --noEmit exit 0, no new errors.
  • Local production build in the sandbox, exit 0 (next build), plus a next start smoke test: /claude-code-for-teams 200, twin .md 200 text/markdown, Accept: text/markdown negotiation 200, trailing slash 308 to the canonical, canonical and rel=alternate in the head, TechArticle and FAQPage in the JSON-LD, entry present in /sitemap.xml, /llms.txt and the /resources hub, opengraph image 200.
  • Zero em dash and zero en dash in the diff, verified with an independent grep.
  • "Shared library" is never used as a definition of the product, and the team's skills are never framed as endorsements; both pinned by a test.

Deviations, declared

  • The Markdown twin is 7,504 words, above the brief but in family with its siblings (/best-claude-skills 7,598, /vercel-skills 7,130, /copilot-skills 8,792). The excess is in table cells rather than prose.
  • The Last reviewed line in llms.txt stays at 2026-08-19. This page re-read only its own sources, so moving it would assert a full re-review that did not happen. Same reasoning and same test as /agent-skills-support, /manage-ai-skills, /vercel-skills and /copilot-skills.
  • The path does not end in -skills, so it needs its own Accept: text/markdown rewrite in next.config.ts, the way /skill-examples does. Covered by a test.

Metric and how we will know

Metric: GSC impressions and clicks on the "claude code for teams" query family (claude code for teams, claude code team plan, claude code enterprise, claude code managed settings, claude code for teams setup).

Baseline today: zero. The family does not appear in any GSC query list we have pulled; the 21 to 24/08 window shows 63 distinct queries and 278 impressions with none of them in this cluster, and the site's dominant query is still "manage ai skills across organisation".

In 2 to 4 weeks we expect:

  • Week 1: the URL indexed. Recent pages have gone from live to "Submitted and indexed" in under 24 hours, so anything past 72 hours is a signal worth chasing.
  • Weeks 2 to 4: first impressions on the family, at any position. Non-zero is the pass mark, because the baseline is zero. The comparable page, /manage-ai-skills, was written for a family that already had 208 impressions; this one is written for a family that has none, so impressions appearing at all is the finding.
  • Weeks 2 to 4, secondary: whether the long tail that lands is the head term or the configuration questions ("claude code managed settings", "claude code settings precedence", "workspace trust"). If it is the second group, the next page in the queue writes itself.
  • Not a metric at 4 weeks: clicks. The site has 7 clicks all time and the only converting query so far was brand. Judging this page on clicks in a month would be judging noise.

Kill criteria, stated in advance: if the URL is indexed and the family is still at zero impressions after 4 weeks, the head term is being taken by Anthropic's own documentation and the answer is not another page on the same intent.

Summary by CodeRabbit

  • New Features

    • Added a comprehensive Claude Code for Teams resource page covering plans, settings, skills, plugins, MCP, workspace trust, rollout guidance, FAQs, and related resources.
    • Added SEO metadata, canonical Markdown access, social preview images, breadcrumbs, structured content, and navigation links.
    • Added contextual calls to action throughout the page with placement-specific analytics tracking.
    • Added redirects and resource-hub integration for the new page.
  • Tests

    • Added comprehensive coverage for routing, content, metadata, links, analytics, and page structure.

Targets the claude code for teams cluster: the searcher is a lead or an
admin who already has Claude Code working for one person and wants to
know what changes for ten. Anthropic answers that across about a dozen
pages, and this one collects them in the order a rollout hits them.

Seven tables: the per-plan admin matrix, the five settings layers in
precedence order, the CLAUDE.md scopes, the skill locations, the plugin
and marketplace mechanisms, the MCP scopes, and Anthropic's own table of
what a repository supplies before the folder itself is trusted. Then a
seven step rollout with a copyable team settings file, the selection
half that no vendor mechanism covers, and six declared gaps.

Differentiated from its neighbours on purpose. /manage-ai-skills keeps
the cross-vendor organisation view and this page drills into the Claude
Code column; /claude-skills keeps the format; /agent-skills-support
keeps the client matrix; /guides/how-to-write-a-skill-md keeps the
authoring rules and this page links to it instead of repeating them.

Every claim was read on 2026-08-24 from code.claude.com and the
Anthropic help center. Four honest findings are in the page rather than
smoothed over: the enterprise skills location has no published path, the
skill precedence runs the opposite way from the settings precedence, the
plan matrix has no column for seat type, and Anthropic states outright
that Claude Code has no built-in registry to browse.
@vercel

vercel Bot commented Aug 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
skillsboard Ready Ready Preview, v0 Aug 24, 2026 1:52pm

Request Review

@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Review Change Stack

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 4f66e110-bbee-418f-ae64-eaed43179c88

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: e85433cb-0485-41de-8532-40381a78c5f7

📥 Commits

Reviewing files that changed from the base of the PR and between cecab35 and 1f3679c.

📒 Files selected for processing (15)
  • analytics/posthog/events.ts
  • app/claude-code-for-teams/layout.tsx
  • app/claude-code-for-teams/opengraph-image.tsx
  • app/claude-code-for-teams/page.tsx
  • app/claude-code-for-teams/twitter-image.tsx
  • components/claude-code-for-teams/claude-code-for-teams-page.tsx
  • components/resources/resource-chrome.tsx
  • lib/seo/claude-code-for-teams/index.ts
  • lib/seo/claude-code-for-teams/types.ts
  • lib/seo/claude-skills/index.ts
  • lib/seo/manage-ai-skills/index.ts
  • lib/seo/resources.ts
  • next.config.ts
  • public/llms.txt
  • tests/claude-code-for-teams.test.mjs

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


Walkthrough

Adds a Claude Code for Teams resource page with typed content, article rendering, SEO metadata, social image routes, Markdown access, resource registration, related links, CTA analytics locations, and comprehensive tests.

Changes

Claude Code for Teams resource

Layer / File(s) Summary
Content contract and article definition
lib/seo/claude-code-for-teams/*
Defines the route, CTA placements, typed article schema, rollout guidance, FAQs, sources, related resources, and social metadata.
Resource page rendering
components/claude-code-for-teams/*, components/resources/resource-chrome.tsx
Renders the typed content with structured data, navigation, article sections, sources, related resources, and CTA placements.
Route and SEO delivery
app/claude-code-for-teams/*, next.config.ts, analytics/posthog/events.ts
Adds the page route, layout, Open Graph and Twitter image routes, metadata, Markdown rewrite, trailing-slash redirect, and CTA analytics locations.
Resource registration and discovery
lib/seo/resources.ts, lib/seo/claude-skills/index.ts, lib/seo/manage-ai-skills/index.ts, public/llms.txt
Registers the resource in the resource hub and topic cluster, and adds related links and llms.txt discovery entries.
Resource validation tests
tests/claude-code-for-teams.test.mjs
Validates routing, assets, Markdown output, content structure, links, structured data, copy constraints, and source integrity.

Estimated code review effort: 4 (Complex) | ~45 minutes

Merge Risk: ⚪ Minimal · up to 1f367

This PR adds a documented rollout page and supporting SEO and navigation changes, with the supplied checks passing. No actionable merge-blocking risk remains beyond normal review.

Sequence Diagram(s)

sequenceDiagram
  participant Browser
  participant NextRoute
  participant ResourceShell
  participant ClaudeCodeForTeamsPage
  participant MarkdownAPI
  Browser->>NextRoute: request /claude-code-for-teams
  NextRoute->>ResourceShell: apply page layout
  ResourceShell->>ClaudeCodeForTeamsPage: render typed resource content
  ClaudeCodeForTeamsPage-->>Browser: return HTML and SEO metadata
  Browser->>NextRoute: request Markdown with Accept header
  NextRoute->>MarkdownAPI: rewrite request with resource path
  MarkdownAPI-->>Browser: return Markdown content
Loading

Poem

I’m a rabbit with a changelog bright,
Four CTA paths now hop in sight.
Teams content, sources, tables too,
SEO images join the queue.
Tests nibble every link in line—
Thump, thump, the resource is fine!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title identifies the new route and its primary purpose as a Claude Code for Teams rollout page.
Description check ✅ Passed The description clearly explains the page content, validation performed, scope, deviations, and success metric, although it does not use the template headings exactly.
Docstring Coverage ✅ Passed Docstring check was indeterminate for this PR — some files could not be analyzed in time. Not blocking.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch gtm/claude-code-for-teams

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@TommyBez

Copy link
Copy Markdown
Owner Author

@coderabbitai full review

@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown
⚠️ Action not completed

Review rate limited.


Your included review limit is currently reached under our Fair Usage Limits Policy. This review may still proceed through usage-based billing if eligible. Your next included review will be available in 32 minutes.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1f3679c53f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread lib/seo/claude-code-for-teams/index.ts Outdated
Comment on lines +757 to +758
label: "Install the plugin once per team",
body: "Run /plugin marketplace add TommyBez/skillsboard and then /plugin install skills-board@skills-board, and Claude Code has the team library in session. A team that wants it on every clone can put the same marketplace in extraKnownMarketplaces and the plugin in enabledPlugins in the committed .claude/settings.json, which is exactly the mechanism the plugins section above describes.",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Require each teammate to install the plugin

For a fresh teammate cloning the repository, this is not an installation performed “once per team”: the page's own plugins section explains that an external plugin enabled only through project settings remains uninstalled and prompts that teammate to run the install command. Committing extraKnownMarketplaces and enabledPlugins therefore does not put the team library into every clone; revise this guidance to require a per-user install or provisioning through the seed directory.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Founded, fixed in b8ea9c8. The path copy contradicted the plugins section of the same page, which already documents the v2.1.195 behavior: an external plugin enabled only through committed project settings does not load until each teammate runs the printed install command. The label no longer says once per team, and the body now states the install is per user, that a committed extraKnownMarketplaces plus enabledPlugins produces a per teammate prompt with the exact command on first run, and that the seed directory is the promptless provisioning route for containers and CI. Tests 495/495 and typecheck clean on the new head.

@TommyBez

Copy link
Copy Markdown
Owner Author

@CodeRabbit review

@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

The Skills Board path section claimed committing extraKnownMarketplaces
and enabledPlugins installs the plugin once for the whole team. The
plugins section of the same page documents the opposite for external
sources since v2.1.195: each teammate gets an install prompt on first
run. Align the path copy with that behavior and with the seed directory
provisioning route. Raised by Codex review.
@TommyBez
TommyBez merged commit 7fa692c into main Aug 24, 2026
4 checks passed
@TommyBez
TommyBez deleted the gtm/claude-code-for-teams branch August 24, 2026 14:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant