Repository navigation
Fit the description inside claude.ai's 200-character limit - #4
Merged
Merged
Conversation
claude.ai's uploader caps `description` at 200 characters. The Agent Skills spec and the Skills API allow 1024, and spec_validator.py encodes 1024, so this skill passed every local check and would still have been rejected on upload at 461 characters. Shortened rather than truncated. A truncation would have kept the "what it does" half and cut the entire "Use when..." clause, which is the half that decides whether the skill triggers at all -- the opposite of what you want. Both halves are still here at 194 characters. What is gone: BASIC/STANDARD/POWERFUL tier vocabulary, "pre-commit hooks", and "integrating skill QA into CI". Those stop being trigger phrases. "before uploading one to claude.ai" is new, and covers a question people actually ask. Nothing else changes. The description is level-1 metadata: no script reads it, no guide references it, and the body instructions are untouched. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This was referenced Sep 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
claude.ai's uploader caps
descriptionat 200 characters. The Agent Skills spec and the Skills API allow 1024, andspec_validator.pyencodes 1024 — so this skill passed every local check and would still have been rejected on upload at 461 chars.461 → 194. Shortened, not truncated: a 200-char cut would have kept the what it does half and deleted the entire
Use when…clause, which is the half that decides whether the skill triggers.Lost as trigger phrases:
BASIC/STANDARD/POWERFUL,pre-commit hooks,skill QA into CI. Added:before uploading one to claude.ai.No functional change — the description is level-1 metadata. No script reads it, no guide references it, the body is untouched.
Verified: strict
yaml.safe_loadparses ·spec_validatorCONFORMANT ·claim_auditorTRUTHFUL.🤖 Generated with Claude Code