- The upload rejects uppercase letters, spaces, or a mismatched metadata name
- Rename the folder and metadata with the same lowercase hyphenated value, save the file, and create a fresh archive.
- The archive adds an extra wrapper directory or omits files referenced by SKILL.md
- Inspect the archive tree before upload and keep the skill folder at the expected root with every referenced relative path intact.
- The zip includes credentials, customer data, local caches, or internal examples
- Build the archive from an explicit allowlist, inspect its contents, remove sensitive files, and rotate any credential that was exposed.
- Claude invokes an older duplicate or behaves differently from the local test
- Remove or rename stale copies, confirm the active skill, retest with synthetic input, and account for web tools or permissions the local version used.