Documentation
¶
Index ¶
Constants ¶
View Source
const ( // MaxSkillNameLength is the maximum accepted length for skill frontmatter name. MaxSkillNameLength = 64 // MaxDescriptionLength is the maximum accepted length for skill description. MaxDescriptionLength = 1024 // MaxCompatibilityLength is the maximum accepted length for compatibility text. MaxCompatibilityLength = 500 // MaxRecommendedSkillLines is the recommended upper bound for SKILL.md lines. MaxRecommendedSkillLines = 500 )
View Source
const ( // FindingCodeNameMissing reports a missing required name field. FindingCodeNameMissing = "SKILL_NAME_MISSING" // FindingCodeNameInvalid reports an invalid skill name format. FindingCodeNameInvalid = "SKILL_NAME_INVALID" // FindingCodeNameTooLong reports skill names that exceed MaxSkillNameLength. FindingCodeNameTooLong = "SKILL_NAME_TOO_LONG" // FindingCodeNameConsecutiveHyphens reports names containing "--". FindingCodeNameConsecutiveHyphens = "SKILL_NAME_CONSECUTIVE_HYPHENS" // FindingCodeNamePathMismatch reports skill names that do not match canonical source names. FindingCodeNamePathMismatch = "SKILL_NAME_PATH_MISMATCH" // FindingCodeDescriptionMissing reports a missing required description field. FindingCodeDescriptionMissing = "SKILL_DESCRIPTION_MISSING" // FindingCodeDescriptionTooLong reports descriptions that exceed MaxDescriptionLength. FindingCodeDescriptionTooLong = "SKILL_DESCRIPTION_TOO_LONG" // FindingCodeCompatibilityTooLong reports compatibility values that exceed MaxCompatibilityLength. FindingCodeCompatibilityTooLong = "SKILL_COMPATIBILITY_TOO_LONG" // FindingCodeUnknownField reports unknown frontmatter fields. FindingCodeUnknownField = "SKILL_FRONTMATTER_UNKNOWN_FIELD" // FindingCodeDirectorySkillFileName reports non-canonical directory skill filenames. FindingCodeDirectorySkillFileName = "SKILL_DIRECTORY_FILENAME" // FindingCodeSizeRecommendation reports SKILL.md files that exceed MaxRecommendedSkillLines. FindingCodeSizeRecommendation = "SKILL_SIZE_RECOMMENDATION" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Finding ¶
Finding is a single deterministic validator diagnostic.
func ValidateDirectory ¶
func ValidateDirectory(parsed ParsedSkill) []Finding
ValidateDirectory validates source-path and directory-format conventions.
func ValidateMetadata ¶
func ValidateMetadata(parsed ParsedSkill) []Finding
ValidateMetadata validates frontmatter-level skill requirements.
func ValidateParsedSkill ¶
func ValidateParsedSkill(parsed ParsedSkill) []Finding
ValidateParsedSkill validates all configured skill rules for a parsed source.
type ParsedSkill ¶
type ParsedSkill struct {
SourcePath string
CanonicalName string
SourceFormat SourceFormat
LineCount int
FrontMatterKeys []string
Name *string
Description *string
Compatibility *string
}
ParsedSkill is a parsed skill source used as validation input.
func ParseSkillSource ¶
func ParseSkillSource(path string) (ParsedSkill, error)
ParseSkillSource reads and parses a skill source file into validator input.
type Severity ¶
type Severity string
Severity indicates validation finding severity.
const ( // SeverityWarn indicates a non-blocking standards warning. SeverityWarn Severity = "warn" )
type SourceFormat ¶
type SourceFormat string
SourceFormat describes how a source skill is represented on disk.
const ( // SourceFormatFlat is `.agent-layer/skills/<name>.md`. SourceFormatFlat SourceFormat = "flat" // SourceFormatDirectory is `.agent-layer/skills/<name>/SKILL.md`. SourceFormatDirectory SourceFormat = "directory" )
Click to show internal directories.
Click to hide internal directories.