К основному содержанию
скилл CX Codex

contentful-custom-app-enhancement — скилл для Claude Code: доработка

Скилл contentful-custom-app-enhancement для Claude Code разбирает запросы на исправление или развитие существующего приложения Contentful и вносит небольшие проверяемые изменения. Разбирает баг-репорты, отзывы и запросы на новую функцию.

MIT 251 установок ★ 41 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add contentful/skills --skill contentful-custom-app-enhancement -a claude-code
Открыть на GitHub

Что делает contentful-custom-app-enhancement

Скилл направляет работу от описания проблемы к изменению в репозитории приложения: агент уточняет ожидаемое поведение, изучает структуру проекта и выбирает небольшой объём правок. Он охватывает интерфейсы приложения, параметры установки, App Actions и Functions, а также подготовку PR.

Перед правками агент проверяет локальные изменения, тесты и используемые инструменты проекта. Затем планирует изменение, запускает подходящие проверки и описывает, что осталось проверить вручную. Для работы нужны репозиторий существующего приложения и контекст запроса; создание приложения с нуля сюда не входит. Если изменение затрагивает production-данные, авторизацию или новую инфраструктуру, агент должен сначала прояснить детали.

Какие задачи решает

  • исправить баг в существующем приложении Contentful
  • разобрать отзыв редактора и уточнить ожидаемое поведение
  • добавить функцию в sidebar или field editor
  • проверить изменение тестами и подготовить описание PR

Примеры запросов агенту

  • Разберись с этим баг-репортом и исправь поведение существующего приложения Contentful.
  • Добавь запрошенную функцию в sidebar и проверь связанные тесты.
  • Подготовь небольшое изменение для PR по этому отзыву редактора.

Как установить contentful-custom-app-enhancement

1Через Skills CLI (Vercel)

npx skills add contentful/skills --skill contentful-custom-app-enhancement -a claude-code

2Вручную: положить файлы

~/.claude/skills/contentful-custom-app-enhancement/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/contentful-custom-app-enhancement/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о contentful-custom-app-enhancement

Как установить contentful-custom-app-enhancement в Claude Code?

Выполните npx skills add contentful/skills --skill contentful-custom-app-enhancement -a claude-code. Файл скилла находится по пути ~/.claude/skills/contentful-custom-app-enhancement/SKILL.md.

Что делает contentful-custom-app-enhancement?

Помогает исследовать существующее приложение Contentful, внести небольшое изменение по баг-репорту или запросу и проверить результат доступными локально способами.

Подходит ли скилл для создания нового приложения Contentful?

Нет. Он предназначен для доработки уже существующего приложения; создание с нуля относится к contentful-custom-app-from-scratch.

Исходный текст

SKILL.md · MIT
---
name: contentful-custom-app-enhancement
description: >-
  Improve, debug, and extend an existing Contentful App Framework custom app in
  a customer's own repository. Use when users provide a bug report, feature
  request, support note, customer feedback, or direct change request for an
  existing custom app, including app configuration, sidebar, field editor,
  dialog, page, home, App Action, Function, installation parameters, local
  validation, or PR preparation. Also triggers on "fix my Contentful app",
  "improve a custom app", "enhance App Framework app", "debug custom app",
  "update sidebar app", and "custom app feature request". Not for creating a
  brand new app from scratch (contentful-custom-app-from-scratch), generic API
  examples (contentful-api), migrations (contentful-migration), or website
  integration (contentful-nextjs).
license: MIT
metadata:
  author: contentful
  version: "2.0.0"
allowed-tools: mcp__contentful-mcp__* mcp__plugin_contentful_contentful-mcp__*
---

# Contentful Custom App Enhancement

Use this skill to turn a bug report, support note, or feature request into a
small, reviewable improvement for an existing Contentful custom app.

Default to the user's app repository and workflow. Do not assume a specific
repository convention, publication process, or review policy unless the user
provides one.

When a comparable public Contentful Marketplace app or example in Contentful's
public apps repository (`https://github.com/contentful/apps`) exists, use it as
a best practice reference for App Framework patterns and UX polish without
inheriting its release or distribution workflow.

## Inputs

Accept:

- bug reports,
- customer or editor feedback,
- support tickets or issue links,
- screenshots or screen recordings,
- direct requests to change a known custom app,
- partial notes about an App Framework behavior.

If the source material is incomplete, continue with local code and provided
context when the risk is low. Ask a targeted question when the missing answer
could change the user-facing behavior, data writes, authentication, or
deployment path.

## Workflow

### 1. Build the Request Context

Identify:

- original request and affected users,
- current app behavior versus expected behavior,
- Contentful location and workflow affected,
- space, environment, content type, field, locale, and role assumptions,
- external service or credential dependencies,
- evidence available locally and evidence still missing.

Separate confirmed facts from assumptions.

### 2. Inspect the Existing App

Before editing:

- check repository status and avoid overwriting user changes,
- inspect `package.json`, scripts, lockfile, and framework conventions,
- locate the relevant app locations and SDK usage,
- review existing tests and nearby components,
- identify app definition, installation parameters, and deployment notes if they
  exist,
- confirm whether the app uses App SDK, React Apps Toolkit, Forma 36,
  contentful-management, App Actions, Functions, or an external backend.

For a reusable checklist, use
[Enhancement checklist](references/enhancement-checklist.md).

### 3. Decide Whether the Change Is Small Enough

Proceed with implementation when the change can plausibly be:

- scoped to one app,
- explained in one short PR,
- validated locally or in a sandbox,
- reviewed without broad product redesign,
- implemented without risky migrations or secret-handling changes.

Pause and clarify when the request requires:

- production data changes,
- a new external auth model,
- major content model redesign,
- multi-app coordination,
- new backend infrastructure,
- unavailable Function or plan capabilities,
- ambiguous editor behavior.

### 4. Plan the Smallest Useful Change

Write a short plan before editing:

- files or app locations likely to change,
- data read/write behavior,
- UI and validation updates,
- tests or manual verification to run,
- risks and rollback path.

Prefer improving the existing flow over replacing it.

### 5. Implement in the App's Existing Style

- Reuse current framework, routing, hooks, components, and package manager.
- Keep TypeScript precise and avoid broad `any` types.
- Use Forma 36 for Contentful web app UI unless the app already uses another
  deliberate design system.
- Preserve editor trust: show loading, empty, error, permission, and destructive
  action states when relevant.
- Keep configuration UI explicit about what values are stored at installation
  versus instance scope.
- Treat non-secret parameters as readable by space members.
- When runtime locations need installation parameters, prefer
  `sdk.parameters.installation`. Do not add or preserve CMA app-installation
  reads in sidebar, field editor, entry editor, page, dialog, home, mount
  effects, render paths, or click handlers just to retrieve app configuration.
- Do not expose tokens or private credentials in client code.
- Keep changes narrow; avoid unrelated formatting, dependency churn, or
  refactors.

### 6. Validate the Improvement

Run the closest available validation:

- targeted unit or component tests,
- typecheck,
- lint or formatter check,
- production build,
- local dev server smoke test,
- Contentful web app manual flow in a non-production space,
- grep or ripgrep for `appInstallation.getForOrganization`,
  `appInstallation.get`, and `getForOrganization` when installation-parameter
  access is touched, confirming runtime config reads use
  `sdk.parameters.installation` or documenting why a CMA app-installation call
  remains,
- App Action, Function, or backend endpoint test when the change touches
  server-side behavior.

When validation requires credentials or access the agent does not have, explain
exactly what remains for the user to verify.

### 7. Prepare Reviewable Output

If the user wants a commit or PR:

- create a focused branch using the user's repo convention when known,
- keep commits small and conventional,
- do not stage unrelated local files,
- include request context, implementation summary, validation, and open
  questions in the PR draft.

If the user only asked for the fix, end with:

- context,
- assessment,
- implementation summary,
- validation,
- remaining risks or follow-up.

## Guardrails

- Do not force a code change when the better answer is product clarification.
- Do not overfit one vague report without saying what is uncertain.
- Do not widen the scope into a rewrite unless the user asks.
- Do not assume app users have publication or distribution requirements unless
  they say so.
- Do not claim Contentful plan features, SDK behavior, or API limits from memory
  when current official docs should be checked.

## Related Skills

- `contentful-custom-app-from-scratch` - design and build a new custom app.
- `contentful-api` - concrete REST and GraphQL API examples.
- `contentful-migration` - content model migration scripts.
- `contentful-guide` - Contentful concepts and API routing.

© contentful · MIT · contentful/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
experience-ui-bundle-custom-app-generate forcedotcom Скилл experience-ui-bundle-custom-app-generate для Claude Code генерирует CustomApplication в Salesforce и выводит React UI bundle в App Launcher без Digital Experience Site. CX Codex +1 5 300установок image-enhancement-suite dkyazzentwatwa Скилл image-enhancement-suite для Claude Code обрабатывает изображения по одной или пакетно: удаляет фон, собирает спрайты и извлекает палитры в чате с агентом. CX Codex +1 308установок dx-code-analyzer-custom-rule-create forcedotcom Скилл dx-code-analyzer-custom-rule-create для Claude Code создаёт пользовательские правила Salesforce Code Analyzer на базе Regex, PMD и ESLint. Закрывает пробелы во встроенных проверках Apex и метаданных. CX Codex +1 5 000установок langsmith-custom-apps langchain-ai Помогает создавать и менять интерфейсы LangSmith Custom Apps на React и TypeScript. Также он разбирает копирование приложений, проверку логики и подготовку к передаче за пределы организации. CX Codex +1 588установок cms официальный Vercel Labs Скилл помогает подключить Sanity, Contentful, DatoCMS, Storyblok и Builder.io к проектам на Vercel с живым предпросмотром. CX Codex GP ChatGPT +1 4установок Tistory Blog Skin UI/UX Enhancement Pipeline inhyoe Tistory Blog Skin UI/UX Enhancement Pipeline — промпт для ChatGPT, Claude.ai и Claude Code, который превращает тему Tistory Poster в интерфейс с индикатором чтения, плавающим оглавлением и обновлённым сайдбаром. GP ChatGPT ★ 178 201звёзд репо

Из того же набора7

contentful-custom-app-from-scratch contentful-custom-app-from-scratch — скилл для Claude Code, который помогает спроектировать и собрать приложение на Contentful App Framework. Он подключается к задачам создания новой интеграции под рабочий процесс организации. CX Codex +1 3 300установок contentful-api Скилл contentful-api для Claude Code — справочник по REST API Contentful для управления контентом, доставки, превью, изображений и GraphQL; примеры даны на curl. CX Codex +1 429установок contentful-guide Скилл contentful-guide разбирает понятия Contentful и подсказывает, какой API взять под задачу. Полезен, когда проект только знакомится с headless CMS. CX Codex +1 405установок contentful-nextjs Скилл contentful-nextjs подключает Contentful к существующему проекту Next.js: SDK, переменные окружения, клиенты для продакшена и превью, Draft Mode. CX Codex +1 374установок contentful-migration Скилл contentful-migration для Claude Code и других агентов: пишет и запускает миграции контентной модели Contentful — типы контента, поля, валидации, редакторский интерфейс — кодом вместо ручной правки в веб-приложении. CX Codex +1 352установок contentful-personalization Скилл contentful-personalization помогает настроить, расширить и отладить персонализацию в Contentful. Он пригодится при запуске экспериментов или поиске причины, почему персонализация не работает. CX Codex +1 311установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой