Agent skill

API Platform Serialization

by dev-toolings in dev-toolings/superpowers-symfony

Control API Platform serialization with groups, [Context], IRI links (readableLink/writableLink), and custom context builders

MITAuto-check: notes

Install API Platform Serialization

skills CLI
$ npx skills add dev-toolings/superpowers-symfony --skill api-platform-serialization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dev-toolings/superpowers-symfony api-platform-serialization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dev-toolings/superpowers-symfony.git skills-src && mkdir -p .claude/skills && cp -r skills-src/content/skills/api-platform-serialization .claude/skills/api-platform-serialization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
api-platform-serialization
GitHub stars
222
Token cost
~519 tokens
SKILL.md length
231 words
Files
2
Skills in repo
44
Repo updated
First seen
Licence
MIT

At a glance

Control API Platform serialization with groups, [Context], IRI links (readableLink/writableLink), and custom context builders

  • Works in 6 steps: Name groups entity:operation and set… → Tag properties with #[Groups] from the… → Control relations with… → …
  • SKILL.md covers Use when, Default workflow, Guardrails and Progressive disclosure, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

API Platform Serialization is an agent skill from dev-toolings/superpowers-symfony. Control API Platform serialization with groups, [Context], IRI links (readableLink/writableLink), and custom context builders

Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

The repository describes itself as: Claude Code plugin for Symfony 7.4 LTS & 8.x — 44 skills, 7 AI subagents & 13 commands for API Platform v4, Doctrine ORM 3, TDD (Pest/PHPUnit), Messenger, security & DDD. The licence is MIT.

Example prompts

  • “/api-platform-serialization”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Write, Edit, Bash

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Name groups entity:operation and set normalizationContext and denormalizationContext per operation.
  2. Tag properties with #[Groups] from the Serializer Attribute namespace, not the old Annotation one.
  3. Control relations with #[ApiProperty(readableLink: false, writableLink: false)] to force IRIs.
  4. Apply per-property options with #[Context] instead of writing a normalizer.
  5. Add computed fields in a custom normalizer, and dynamic groups in a decorator of api_platform.serializer.context_builder.
  6. Prevent cycles with #[MaxDepth] and enable_max_depth, and hide secrets with #[Ignore].

What it can do on your machine

Read from SKILL.md and the folder at commit 459bcd0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Write
    • Edit
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Platform Serialization loads about 519 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 231 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~519

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Glob, Grep, Write, Edit, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dev-toolings/superpowers-symfony at commit 459bcd0, republished under its MIT licence (© dev-toolings). 231 words, ~519 tokens.

Download SKILL.mdSave it as .claude/skills/api-platform-serialization/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
api-platform-serialization
description
Control API Platform serialization with groups, #[Context], IRI links (readableLink/writableLink), and custom context builders
allowed-tools
Read, Glob, Grep, Write, Edit, Bash
capabilities
read, search, edit, shell
tags
api-platform

Api Platform Serialization (Symfony)

Use when

  • Operations must expose different fields (list, read, create, update).
  • A related resource must render as an IRI or be embedded.
  • A response needs computed or role-dependent fields.
  • A property needs normalizer options such as a date format.

Default workflow

  1. Name groups entity:operation and set normalizationContext and denormalizationContext per operation.
  2. Tag properties with #[Groups] from the Serializer Attribute namespace, not the old Annotation one.
  3. Control relations with #[ApiProperty(readableLink: false, writableLink: false)] to force IRIs.
  4. Apply per-property options with #[Context] instead of writing a normalizer.
  5. Add computed fields in a custom normalizer, and dynamic groups in a decorator of api_platform.serializer.context_builder.
  6. Prevent cycles with #[MaxDepth] and enable_max_depth, and hide secrets with #[Ignore].

Guardrails

  • Use separate read and write groups: for example password only in the create group, id only in read groups.
  • A related resource is embedded only when it shares a group with the parent; otherwise it renders as an IRI.
  • #[MaxDepth] has no effect unless enable_max_depth is true in the context.
  • Keep entities clean: computed fields belong in normalizers.

Progressive disclosure

  • Use this file for execution posture and risk controls.
  • Open references when deep implementation details are needed.

Output contract

  • The groups and contexts per operation, as a field matrix.
  • Normalizers or context builders added, and how they are registered.
  • Tests or OpenAPI output showing the resulting fields.

References

  • reference.md

© dev-toolings, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in content/skills/api-platform-serialization of dev-toolings/superpowers-symfony.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit 459bcd0

Compare with similar skills

API Platform Serialization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Platform Serialization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Platform Serialization this skilldev-toolings/superpowers-symfony222—~519Automated safety check: NotesMIT
Internal Linksthedaviddias/Front-End-Checklist74k—~770Automated safety check: PassMIT
External Linksthedaviddias/Front-End-Checklist74k—~773Automated safety check: PassMIT
Invalid Linksthedaviddias/Front-End-Checklist74k—~806Automated safety check: PassMIT
SEO Aeo Internal Linkingsickn33/agentic-awesome-skills47k1 repos~2.3kAutomated safety check: PassMIT
Link Checkerthedaviddias/Front-End-Checklist74k—~408Automated safety check: PassMIT

Similar skills

  • Internal Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or…

    74k GitHub stars~770 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • External Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing content pages for citation quality, suggesting authoritative sources to link for factual claims, or reviewing whether a page's external link attributes…

    74k GitHub stars~773 tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Invalid Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a page's link elements for crawlability, reviewing JavaScript-heavy SPAs where navigation may not use <a href tags, or checking that dynamically generated links…

    74k GitHub stars~806 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • SEO Aeo Internal Linking

    sickn33/agentic-awesome-skills

    Maps internal link opportunities between pages with relevant anchor text, placement instructions, orphan-page detection, and cannibalisation checks.

    47k GitHub starsUsed in 1 repo~2.3k tokens
    Marketing & SEOAuto-check passed
  • Link Checker

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Check for broken links.

    74k GitHub stars~408 tokensUpdated 2 days ago
    Auto-check passed
  • Article Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Optimize article link density.

    74k GitHub stars~425 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from dev-toolings/superpowers-symfony

All 44 skills in this repo
  • Symfony Scheduler

    dev-toolings/superpowers-symfony

    Schedule recurring tasks with the Symfony Scheduler component (native since 7.x); define schedules, triggers, and integrate with Messenger

    222 GitHub stars~526 tokensUpdated 3 days ago
    Auto-check: notes
  • API Platform Dto Resources

    dev-toolings/superpowers-symfony

    Map entities to API DTOs in API Platform (v5, 4.4, 4.3) with the Symfony Object Mapper ([Map], stateOptions) for decoupled input/output contracts

    222 GitHub stars~593 tokensUpdated 3 days ago
    Auto-check: notes
  • API Platform Filters

    dev-toolings/superpowers-symfony

    Implement API Platform filters - Parameters API (QueryParameter, v5/4.4/4.3) and the [ApiFilter] attribute deprecated since 4.4 - for search, date, range, boolean, and custom filtering

    222 GitHub stars~610 tokensUpdated 3 days ago
    Auto-check: notes
  • API Platform Resources

    dev-toolings/superpowers-symfony

    Configure API Platform resources (v5, 4.4, 4.3) with explicit operations, pagination, and typed OpenAPI for clean, versioned REST/GraphQL APIs

    222 GitHub stars~560 tokensUpdated 3 days ago
    Auto-check: notes
  • API Platform Security

    dev-toolings/superpowers-symfony

    Secure API Platform resources with security expressions, voters, securityPostValidation, and operation-level access control

    222 GitHub stars~551 tokensUpdated 3 days ago
    Auto-check: notes
  • API Platform State Providers

    dev-toolings/superpowers-symfony

    Master API Platform State Providers and Processors (v5, 4.4, 4.3) (ProviderInterface/ProcessorInterface) to decouple data retrieval and persistence from entities

    222 GitHub stars~567 tokensUpdated 3 days ago
    Auto-check: notes

Questions about API Platform Serialization

What does API Platform Serialization do?

Control API Platform serialization with groups, [Context], IRI links (readableLink/writableLink), and custom context builders. API Platform Serialization is an agent skill from dev-toolings/superpowers-symfony.

How do I install API Platform Serialization in Claude Code?

Run `npx skills add dev-toolings/superpowers-symfony --skill api-platform-serialization -a claude-code`. Or copy the skill folder (content/skills/api-platform-serialization in dev-toolings/superpowers-symfony) into .claude/skills/api-platform-serialization in your project. Claude Code loads it when a task matches its description.

How do I install API Platform Serialization in Codex?

Run `npx skills add dev-toolings/superpowers-symfony --skill api-platform-serialization -a codex`. Or copy the skill folder (content/skills/api-platform-serialization in dev-toolings/superpowers-symfony) into .agents/skills/api-platform-serialization in your project. Codex loads it when a task matches its description.

Can I use API Platform Serialization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dev-toolings/superpowers-symfony --skill api-platform-serialization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-platform-serialization, .gemini/skills/api-platform-serialization, .github/skills/api-platform-serialization and .opencode/skills/api-platform-serialization in your project.

What does API Platform Serialization need to run?

SKILL.md names no scripts, command-line tools or credentials: API Platform Serialization is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep, Write, Edit, Bash.

Does API Platform Serialization access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Platform Serialization safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does API Platform Serialization use?

API Platform Serialization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Platform Serialization use?

About 519 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Platform Serialization?

Skills that share tags, products or a category with API Platform Serialization: Internal Links (thedaviddias/Front-End-Checklist, 74k stars), External Links (thedaviddias/Front-End-Checklist, 74k stars), Invalid Links (thedaviddias/Front-End-Checklist, 74k stars) and SEO Aeo Internal Linking (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Platform Serialization?

dev-toolings (a GitHub organization) maintains it in dev-toolings/superpowers-symfony, which has 222 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 5, 2026.

Source: dev-toolings/superpowers-symfony on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.