Shipping Across Surfaces
Land a change everywhere the same fact is stated — enumerating the full surface inventory (landing copy, docs, machine-readable summaries, changelog badges repeated across every page, sitemap, README, descriptions embedded in code, and untyped frontend consumers of typed responses), generating a surface instead of restating it, drift tests where you cannot generate, never hand-maintaining a copy of a surface another codebase owns, shipping a paired PR when you change a format a different codebase decodes, and keeping overloaded product words apart. Use when adding or renaming a user-facing fea
Install
/plugin marketplace add wdm0006/python-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add wdm0006/python-skills --skill shipping-across-surfacesgit clone --depth 1 https://github.com/wdm0006/python-skills.git /tmp/python-skills
mkdir -p ~/.claude/skills
cp -r /tmp/python-skills/skills/common/cross-surface-changes ~/.claude/skills/shipping-across-surfacesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Shipping Across Surfaces Most product facts are stated more than once. The feature exists in code, is described on a landing page, summarized for agents, listed in a changelog, repeated in a nav badge, restated in a README, and embedded again in the description string of every tool or endpoint that exposes it. Each copy drifts independently, and none of them are covered by tests. The failure is never loud. Nothing goes red; the product simply describes itself inaccurately in the four places you didn't edit, and the one place a reader happened to look is the stale one. ## Enumerate the surface inventory once, in the repo "I'll remember the other places" does not survive the second feature. Write the list down — in `CONTRIBUTING.md`, a PR template, or the skill/guide the project already keeps — and treat it as the definition of done for a user-facing change. A realistic inventory for a product with a public site: - Landing page: hero, section ledes, the feature cards, the free/paid list - `<meta>` / OG / Twitter tags, and the structured data (`SoftwareApplication` description, `FAQPage` entries) — search engines read the copy you forgot - Docs page, and any machine-readable summary for agents (`llms.txt`) - Changelog entry **and** the version badge repeated in the nav of every page - Sitemap, and the footer product column present on every page - README, comparison pages, onboarding/skill files - **The descriptions embedded in code** — every tool, command, or endpoint
Details
- Skill name
shipping-across-surfaces- Repository
- wdm0006/python-skills
- Path
skills/common/cross-surface-changes/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
FAQ
What does the Shipping Across Surfaces skill do?
Land a change everywhere the same fact is stated — enumerating the full surface inventory (landing copy, docs, machine-readable summaries, changelog badges repeated across every page, sitemap, README, descriptions embedded in code, and untyped frontend consumers of typed responses), generating a surface instead of restating it, drift tests where you cannot generate, never hand-maintaining a copy of a surface another codebase owns, shipping a paired PR when you change a format a different codebase decodes, and keeping overloaded product words apart. Use when adding or renaming a user-facing fea
How do I install the Shipping Across Surfaces skill?
Claude Code plugin: /plugin marketplace add wdm0006/python-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Shipping Across Surfaces popular?
It lives in wdm0006/python-skills, which has 115 GitHub stars and 18 forks.
Related skills
Auditing Python Security
115wdm0006/python-skills
Audits Python libraries for security vulnerabilities using Bandit, pip-audit, Semgrep, and detect-secrets. Identifies SQL injection, command injection, hardcoded credentials, secrets exposed through tracebacks, weak cryptography, and insecure deserialization. Use when reviewing library security, setting up security scanning in CI, or implementing secure coding patterns.
Building Accessible Interfaces
115wdm0006/python-skills
Makes web and app UIs usable by keyboard, screen-reader, low-vision and motion-sensitive users — semantic HTML before ARIA, labelled controls, visible focus, WCAG AA contrast measured rather than eyeballed, touch targets, reduced motion, and automated axe checks plus a manual keyboard pass in CI or before every UI PR. Use when building or restyling a screen, adding a form, modal, menu or custom control, choosing colors, or reviewing a UI change.
Building Browser Extensions
115wdm0006/python-skills
Builds and tests Manifest V3 browser extensions — service-worker message channels that survive teardown, chrome.storage read-modify-write safety, settings validation in the popup, and a Jest chrome mock that can actually fail. Use when writing or reviewing a background service worker, a popup that reads/writes chrome.storage, an extension's Jest suite, or debugging an extension whose UI silently stops responding.
Swedish Industry SAAS
105erp-mafia/accounted-skills
Swedish accounting for SaaS and software companies. Covers subscription revenue: the gap between invoicing, cash and revenue, förutbetalda intäkter on 2970, K2 6.11 vs K3 23.26, multi-component contracts (licence, implementation, support), setup fees, usage billing, credits and free months, refunds and churn provisions, principal vs agent for resellers and app stores, FX invoicing, and reconciling ARR/MRR against bokförd intäkt; plus VAT and development: EU B2B reverse charge, OSS and the 99 680 kr threshold, location evidence, elektroniskt tillhandahållna tjänster, capitalising development co
Setting Up Python Libraries
115wdm0006/python-skills
Sets up professional Python library projects with modern tooling (pyproject.toml, uv, ruff, pytest, pre-commit, GitHub Actions). Use when creating new Python libraries, modernizing existing projects to pyproject.toml, configuring linting/testing/CI, or setting up Makefiles and pre-commit hooks.
Wp Admin UI Development
116jorgerosal/wordpress-skills
WordPress admin UI review for Codex. Use when reviewing settings pages, admin menus, notices, screen targeting, admin form flows, and capability-aware plugin interfaces.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.