Package io.github.duckasteroid.agentdocs.publish.validation

Class SkillDescriptionRule

java.lang.Object
io.github.duckasteroid.agentdocs.publish.validation.SkillDescriptionRule
All Implemented Interfaces:
AgentDocsValidationRule
public final class SkillDescriptionRule extends Object implements AgentDocsValidationRule
Validates optional description frontmatter length.

Presence is not required: per the Agent Docs convention, an author's description is appended to a resolver-generated prefix when present, so omitting it entirely (or omitting frontmatter altogether) is valid and the resolver's generated description still applies.

The cap is well under the Agent Skills format's own 1024-character description limit, reserving headroom for the resolver-generated prefix sentence prepended ahead of the author's text (see SkillDirectoryManager.buildDescription in the resolve plugin). This rule deliberately doesn't compute the resolver's exact prefix length itself - that would couple the publish and resolve plugins' string formats together - it just reserves a conservative fixed margin comfortably larger than any prefix the resolver is expected to generate.