## Build Validation Skill The [Apple Style Guide](https://help.apple.com/itc/musicstyleguide/en.lproj/static.html) is occasionally updated and the rules that the validation skills use can change over time. This task should rebuild the specified skills using the provided instructions. ## List of Validation Skills - validate-classical-metadata - validate-release-metadata - validate-track-metadata ### General Skill Structure The skills live in the `.claude/skills` directory Each skill directory contains: - `SKILL.md` - Skill metadata, quick reference, key rules summary - `*_RULES.md` - Complete validation rules with section numbers from Apple Music Style Guide **Important**: The `*_RULES.md` files are the source of truth for validation logic. When modifying validation behavior, update these files, as skills read them during validation. ### General Validation Information ### Severity Levels When validating, use these severity levels: - **critical**: Issues that will cause style guide infractions or significantly impact functionality (e.g., Apple trademark violations, missing primary artist, missing required fields) - **high**: Important issues that should be fixed but may not cause rejection - **medium**: Standard issues that affect quality and discoverability - **low**: Minor issues or informational notes ### Individual Rule Structure - Name format should include the section and subsection from the style guide, the name of the rule, and a severity level. Example: ** {Section Number}.{Sub Section Number} {Name of the rule} - {severity level} ** - Body format should be the key points of what needs to be checked and validated. A concise description or list of what needs to be validated. ### Build validate-classical-metadata - Analyze the current `validate-classical-metadata` skill if it exists for how to format the .md files. - Delete and recreate the skill directory `validate-classical-metadata` in `.claude/skills` if it already exists. - Create `SKILL.md`, give it the name of "validate-classical-metadata" and a description of "Validate classical music products against Apple Music Style Guide classical rules. Use when validating classical albums, tracks with classical genre, or when user mentions classical music validation." - Parse the [Apple Style Guide](https://help.apple.com/itc/musicstyleguide/en.lproj/static.html) link for all rules related to the classical genre. Including but not limited to the whole of Section 13. Don't care about validations that are not a digital musical product or for artwork, ie. music videos bookelets, album covers. Note when something is optional or not strictly required as it should be non blocking severity. - Create a new file `CLASSICAL_RULES.md` with all the classical rules using the individual rule structure provided above. Please keep the section and subsection numbers and name consistent with what they are in the Apple Style Guide. - Add a section "Key Rules" to `SKILL.md` that highlights the most important rules using the individual rule structure provided above. - In `SKILL.md` link to `CLASSICAL_RULES.md` for all the rules. - Add a section to the the top of `SKILL.md` with a summary of what the skill does. - Add another section under the summary section for exceptions to the rules that can be added manually as needed. Don't prepopulate this field. - Include the Severity Level definition in the `SKILL.md`. - Don't provide the Apple Style Guide as a reference for the skill to use. ### Build validate-track-metadata - Analyze the current `validate-track-metadata` skill if it exists for how to format the .md files. - Delete and recreate the skill directory `validate-track-metadata` in `.claude/skills` if it already exists. - Create `SKILL.md`, give it the name of "validate-track-metadata" and a description of "Validate track-level metadata against Apple Music Style Guide rules. Use when validating track titles, artists, version info, explicit content flags, and composer/songwriter credits." - Parse the [Apple Style Guide](https://help.apple.com/itc/musicstyleguide/en.lproj/static.html) link for all rules related to track validations. Don't care about validations that are not a digital musical product or for artwork, ie. music videos bookelets, album covers. Note when something is optional or not strictly required as it should be a non blocking severity. - Create a new file `TRACK_RULES.md` with all the rules using the individual rule structure provided above. Please keep the section and subsection numbers and name consistent with what they are in the Apple Style Guide. - Add a section "Key Rules" to `SKILL.md` that highlights the most important rules using the individual rule structure provided above. - In `SKILL.md` link to `TRACK_RULES.md` for all the rules. - Add a section to the the top of `SKILL.md` with a summary of what the skill does. - Add another section under the summary section for exceptions to the rules that can be added manually as needed. Don't prepopulate this field. - Include the Severity Level definition in the `SKILL.md`. - Don't provide the Apple Style Guide as a reference for the skill to use. ### Build validate-release-metadata - Analyze the current `validate-release-metadata` skill if it exists for how to format the .md files. - Delete and recreate the skill directory `validate-release-metadata` in `.claude/skills` if it already exists. - Create `SKILL.md`, give it the name of "validate-release-metadata" and a description of "Validate album-level (release-level) metadata against Apple Music Style Guide rules. Use when validating album titles, album artists, genres, release dates, copyright, and other release-level metadata. - Parse the [Apple Style Guide](https://help.apple.com/itc/musicstyleguide/en.lproj/static.html) link for all rules related to album level validations. Don't care about validations that are not a digital musical product or for artwork, ie. music videos bookelets, album covers. Note when something is optional or not strictly required as it should be a non blocking severity. - Create a new file `RELEASE_RULES.md` with all the rules using the individual rule structure provided above. Please keep the section and subsection numbers, and name consistent with what they are in the Apple Style Guide. - Add a section "Key Rules" to `SKILL.md` that highlights the most important rules using the individual rule structure provided above. - In `SKILL.md` link to `RELEASE_RULES.md` for all the rules. - Add a section to the the top of `SKILL.md` with a summary of what the skill does. - Add another section under the summary section for exceptions to the rules that can be added manually as needed. Don't prepopulate this field. - Include the Severity Level definition in the `SKILL.md`. - Don't provide the Apple Style Guide as a reference for the skill to use.