Asc metadata
Skill raydeveloperF/App-Store-Connect-release-kit/skills/asc-metadata
Write localized ASC metadata for iOS apps, including subtitle, promotional text, and app description. Use when the user asks for App Store Connect listing copy, ASC metadata, localized subtitle, promotional text, or app description. This skill requires project understanding first, and must ask for missing target languages or writing style before producing final copy.From its SKILL.md
npx -y skills add raydeveloperF/App-Store-Connect-release-kit --skill asc-metadataAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
5.1 KB, ~1.0k tokens by cl100k_base, as published. Nobody here has run it
ASC Metadata
Use this skill to write localized App Store Connect copy for these fields only:
SubtitlePromotional TextApp Description
Do not generate keywords, screenshot headlines, release notes, privacy copy, or pricing copy unless the user separately asks for them.
Required Inputs
The only input that cannot be inferred: target locales (e.g. en-US, zh-Hans).
If target locales are missing and were not provided by the caller, ask once and stop.
Writing style defaults to 平静内敛 when not specified. Do not ask for it.
Project Context First
Before writing specific metadata, gather enough context to understand the app. If a local project or workspace is available, inspect relevant files read-only unless the user asks for edits:
- README, product docs, planning docs, marketing copy, or existing App Store metadata.
- App entry points, main screens, feature modules, localization files, and screenshots if available.
- Existing title, subtitle, keywords, screenshots, and product positioning, if present.
Build a short working brief before drafting:
- App name, platform, category, and target audience.
- Core user job and the 3-5 strongest implemented features.
- Main emotional promise or practical value.
- Constraints from existing brand voice, screenshots, title, or keywords.
- Locale-specific wording risks, cultural fit, and product differences.
If the available project context is too thin, ask focused follow-up questions or label the output as a context-limited draft. Do not invent unsupported features, claims, awards, integrations, subscription terms, privacy guarantees, or medical/legal/financial promises.
Field Rules
Use current App Store Connect limits unless the user provides different constraints:
- Subtitle: at most 30 characters.
- Promotional Text: at most 170 characters.
- App Description: at most 4000 characters, plain text, line breaks allowed, no HTML.
For every locale:
- Write in the target language, not merely translated English.
- Preserve the requested writing style.
- Keep claims grounded in the inspected project.
- Avoid duplicate wording between subtitle and the first line of the description when possible.
- Prefer concrete value over generic praise.
- Avoid filler like "best", "ultimate", "revolutionary", and unsupported superlatives.
- Do not mention Apple, iPhone, iOS, App Store, or platform terms as selling points unless directly relevant and allowed.
Default Style: 平静内敛
When the user chooses the default style, use calm, restrained product language:
- Clear, precise, and low-pressure.
- Warm but not sentimental.
- Confident without hype.
- Short sentences, concrete nouns, few exclamation marks.
- Let the app's actual behavior carry the persuasion.
Drafting Workflow
-
Understand the project.
- Inspect project evidence first when available.
- Summarize the working brief in 3-6 bullets before final copy.
-
Draft per locale.
- Produce all three fields for every requested locale.
- Fit each field within its limit.
- Adapt wording culturally instead of doing literal translation.
-
Self-check.
- Count characters for subtitle and promotional text.
- Check the description is under 4000 characters.
- Check each claim against project evidence.
- Flag any assumption or weak evidence.
Output Format
Start with a compact project brief:
**Project Brief**
- App:
- Audience:
- Core value:
- Strongest features:
- Style:
Then provide one section per locale:
## zh-Hans
| Field | Copy | Count |
| --- | --- | ---: |
| Subtitle | `...` | 12/30 |
| Promotional Text | `...` | 86/170 |
**App Description**
...
Count: 620/4000
End with:
Assumptions: only if anything was inferred.Evidence checked: the files, screens, docs, or user-provided facts used.Manual review: locale or App Store Connect checks the user should run before shipping.
Quality Bar
A good result:
- Provides subtitle, promotional text, and app description for every requested language.
- Respects all character limits.
- Sounds native in each locale.
- Matches the requested style, especially
平静内敛when selected. - Is grounded in the real project rather than a generic app category.
- Is ready to paste into App Store Connect after human locale review.
Finally, write the complete Markdown output, grouped by language, to a file:
- If the caller provided an output path (for example, as a subagent receiving
output path: /some/path/asc-metadata.md), write to that exact path. - If no output path was provided, write to
asc-metadata.mdin the current working directory.
After writing, confirm the absolute path of the written file in your completion summary so the caller can locate it.
What ships with it: 1 file
263 B alongside SKILL.md
agents/
- openai.yaml263 B
Gives 0 of the 12 instructions most docs writing skills give in ~1.0k tokens
Counted across 1,951 of the 3,904 authors here whose files we hold, read 2026-09-06
- Use third-person for skill descriptionsin 54 of 1951, across 35 files
- Start descriptions with Use whenin 43 of 1951, across 29 files
- Run baseline scenarios before writing any skillin 40 of 1951, across 26 files
- Use active voicein 40 of 1951, across 36 files
- Map file responsibilities before defining tasksin 36 of 1951, across 29 files
- Use checkbox syntax for tracking stepsin 35 of 1951, across 27 files
- Ask one question at a timein 35 of 1951
- Offer execution options after saving the planin 33 of 1951, across 24 files
- Include complete code in every stepin 33 of 1951, across 27 files
- Design units with clear boundaries and interfacesin 31 of 1951, across 23 files
- Announce the skill usage at the startin 30 of 1951
- Verify agent compliance after adding the skillin 29 of 1951, across 17 files
Said here and by no other author read
- Inspect project files to understand the app
- Ask for target locales if missing
- Summarize a working brief before drafting
- Write metadata in the target language
- Use calm and restrained product language
- Keep subtitle under 30 characters
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.