Seven of the 28 skills in this pack carry a description longer than the documented 1024 character maximum. Descriptions are the part of a skill that always sits in context, so this is the field with the tightest budget.
Anthropic's guidance is here: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
Over the description limit
| Skill |
Characters |
seo/seo-analysis/SKILL.md |
1382 |
seo/hreflang-international/SKILL.md |
1129 |
seo/ecommerce-seo/SKILL.md |
1099 |
seo/local-seo/SKILL.md |
1091 |
seo/sxo/SKILL.md |
1070 |
seo/programmatic-seo/SKILL.md |
1057 |
seo/seo-page/SKILL.md |
1050 |
I opened four of these and counted the field by hand, seo-analysis, hreflang-international, programmatic-seo and seo-page, and got the same numbers. The counts are of the description value with the leading > and surrounding whitespace collapsed, so a different counting convention could shift them by a few characters. None of them shifts enough to come in under 1024.
The overage is mostly the trailing routing sentences, the "for full-site audits use /seo-analysis, for a single URL use /seo-page" pattern that several of these end with. That routing is useful, so the cheapest fix is probably to keep one clause of it rather than the full list.
Smaller things, in the same pass
seo/seo-analysis/SKILL.md has a 1328 line body against the 500 line guideline. Everything after the frontmatter loads the moment the skill fires, so this one is worth splitting into references/. seo/seo-page/SKILL.md is at 501 lines, which is over the same guideline by one line and not worth touching on its own.
Eight reference files run past 100 lines with no table of contents at the top:
| File |
Lines |
seo/schema-markup-generator/references/schema-templates.md |
631 |
seo/schema-markup-generator/references/validation-guide.md |
444 |
seo/meta-tags-optimizer/references/meta-tag-formulas.md |
355 |
seo/keyword-research/references/keyword-intent-taxonomy.md |
324 |
seo/keyword-research/references/topic-cluster-templates.md |
286 |
seo/seo-analysis/references/gsc_setup.md |
199 |
seo/meta-tags-optimizer/references/meta-tag-code-templates.md |
153 |
seo/meta-tags-optimizer/references/ctr-and-social-reference.md |
149 |
The docs ask for a table of contents above 100 lines so that a partial read still shows what else is in the file. I checked four of these by hand, schema-templates, validation-guide, meta-tag-formulas and keyword-intent-taxonomy, and each opens straight into a heading with no contents list. This is a guideline rather than a limit, so it is the lowest priority item here.
I checked these findings by hand before writing this up, and I am happy to be told any of it does not matter to you. What brought me here was a checker I maintain that reads published skill packs against the Anthropic guidance, so I am saying that up front rather than leaving you to wonder. I have not seen a skill fail to load because of the description length, the limit is the documented one rather than an error I reproduced. If you would rather not get this kind of report, tell me and I will not send another.
Seven of the 28 skills in this pack carry a
descriptionlonger than the documented 1024 character maximum. Descriptions are the part of a skill that always sits in context, so this is the field with the tightest budget.Anthropic's guidance is here: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
Over the description limit
seo/seo-analysis/SKILL.mdseo/hreflang-international/SKILL.mdseo/ecommerce-seo/SKILL.mdseo/local-seo/SKILL.mdseo/sxo/SKILL.mdseo/programmatic-seo/SKILL.mdseo/seo-page/SKILL.mdI opened four of these and counted the field by hand,
seo-analysis,hreflang-international,programmatic-seoandseo-page, and got the same numbers. The counts are of the description value with the leading>and surrounding whitespace collapsed, so a different counting convention could shift them by a few characters. None of them shifts enough to come in under 1024.The overage is mostly the trailing routing sentences, the "for full-site audits use /seo-analysis, for a single URL use /seo-page" pattern that several of these end with. That routing is useful, so the cheapest fix is probably to keep one clause of it rather than the full list.
Smaller things, in the same pass
seo/seo-analysis/SKILL.mdhas a 1328 line body against the 500 line guideline. Everything after the frontmatter loads the moment the skill fires, so this one is worth splitting intoreferences/.seo/seo-page/SKILL.mdis at 501 lines, which is over the same guideline by one line and not worth touching on its own.Eight reference files run past 100 lines with no table of contents at the top:
seo/schema-markup-generator/references/schema-templates.mdseo/schema-markup-generator/references/validation-guide.mdseo/meta-tags-optimizer/references/meta-tag-formulas.mdseo/keyword-research/references/keyword-intent-taxonomy.mdseo/keyword-research/references/topic-cluster-templates.mdseo/seo-analysis/references/gsc_setup.mdseo/meta-tags-optimizer/references/meta-tag-code-templates.mdseo/meta-tags-optimizer/references/ctr-and-social-reference.mdThe docs ask for a table of contents above 100 lines so that a partial read still shows what else is in the file. I checked four of these by hand,
schema-templates,validation-guide,meta-tag-formulasandkeyword-intent-taxonomy, and each opens straight into a heading with no contents list. This is a guideline rather than a limit, so it is the lowest priority item here.I checked these findings by hand before writing this up, and I am happy to be told any of it does not matter to you. What brought me here was a checker I maintain that reads published skill packs against the Anthropic guidance, so I am saying that up front rather than leaving you to wonder. I have not seen a skill fail to load because of the description length, the limit is the documented one rather than an error I reproduced. If you would rather not get this kind of report, tell me and I will not send another.