From skill-cefailures
Use when authoring or updating user-capability documentation (`capabilities.md` files) co-located with route folders, screen components, feature folders, or API endpoints. Use when planning, brainstorming, or specifying any user-facing feature change. Use when reviewing whether a `capabilities.md` is in sync with the code it describes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/skill-cefailures:capabilities-sdlcThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Documents the conventions for the Proposit capabilities-SDLC: how user-facing capabilities are described in markdown files co-located with the code they describe, what the planning gate is, and how cross-repo capability drift is avoided.
docs/contradiction-detection.mddocs/exemplars/mobile-feature-folder.mddocs/exemplars/mobile-screen.mddocs/exemplars/server-api-endpoint.mddocs/exemplars/server-user-route.mddocs/file-locations.mddocs/format.mddocs/planning-gate.mddocs/product-layer-coordination.mddocs/route-edge-cases.mddocs/statuses.mdDocuments the conventions for the Proposit capabilities-SDLC: how user-facing capabilities are described in markdown files co-located with the code they describe, what the planning gate is, and how cross-repo capability drift is avoided.
capabilities.md file exists or is being authored for a route, screen, feature folder, or API endpoint in a Proposit repo.Every brainstorm, spec, plan, or briefing for user-facing work opens with a ## Capability changes section as its first content section. See docs/planning-gate.md for the full rule, including the bug-fix carve-outs (regression vs. discovery vs. capability-change-disguised-as-bug-fix).
Before completing a code change that affects user-facing behavior, check whether the change contradicts any existing capabilities.md entry — by status, by described scope, or by listed conditions. If it does, surface the contradiction to the user and ask whether to update the capabilities.md to match the new behavior or revise the change to fit the existing entry. Do not silently update the capabilities.md. See docs/contradiction-detection.md for the full rule, contradiction shapes, and the surfacing template.
| Doc | Scope |
|---|---|
docs/file-locations.md | Where capabilities.md files live in proposit-server and proposit-mobile, and what is not in scope for capability documentation. |
docs/format.md | The skeleton, conventions, and reference style for a single capability and a single file. |
docs/statuses.md | The three-status taxonomy (Supported, Missing, Omitted) with body-content rules and the rejected-fourth-status note. |
docs/planning-gate.md | The ## Capability changes requirement for plans and specs, including the bug-fix and discovery-fix exceptions. |
docs/contradiction-detection.md | The at-the-moment-of-change rule: detect contradictions between proposed code changes and existing capabilities.md entries, surface them, never silently reconcile. |
docs/product-layer-coordination.md | How per-repo agents query the orchestrator for product-layer wording, and the coordination-unavailable fallback. Transport-agnostic. |
docs/route-edge-cases.md | Server route enumeration: route groups, infra files, layouts, dynamic segments, catch-alls, parallel and intercepting routes, multi-method API routes, middleware. |
docs/exemplars/server-user-route.md | Fully-written exemplar for a server user route (/login-style). |
docs/exemplars/server-api-endpoint.md | Fully-written exemplar for a server API endpoint (multi-method case). |
docs/exemplars/mobile-feature-folder.md | Fully-written exemplar for a mobile feature folder (cross-screen flows). |
docs/exemplars/mobile-screen.md | Fully-written exemplar for a mobile screen component (screen-local). |
capabilities.md co-located with code in each consuming repo. Per-repo files do not link to or reference anything outside their repo.proposit-orchestration/docs/capabilities/<area>.md, owned by the orchestrator. Per-repo agents do not read this layer; the orchestrator relays product-layer wording on request (see docs/product-layer-coordination.md).# <Subject> — capabilities
## <Capability name>
**Status:** Supported | Missing | Omitted
<1–3 short paragraphs of body content; rules vary by status — see docs/statuses.md.>
No frontmatter. No formal IDs. No cross-repo links from per-repo files.
Every consuming repo's CLAUDE.md should include this entry under its ## Documentation Sync section so that capability files are kept in sync with code changes:
- `**/capabilities.md` [User-Capabilities] — Per-route/screen/feature user-capability docs.
The trigger fires when a code change in the same directory or its subtree alters
user-facing behavior. The `skill-cefailures:capabilities-sdlc` skill describes the format,
status taxonomy, and the planning-gate rule.
The **/capabilities.md glob is intentional and unusual — most existing doc-sync entries name a single concrete path. Reviewers evaluate this trigger against any matching file in the diff.
proposit-orchestration/docs/capabilities/<area>.md; per-repo agents do not read those files.CLAUDE.md, and per-repo CLAUDE.md notes.FOLLOWUPS.md).npx claudepluginhub brocef/skill-cefailures --plugin skill-cefailuresProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.