skillmd

package

v0.41.0 Latest Latest Go to latest Published: Jul 23, 2026 License: MIT Imports: 7 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/DonaldMurillo/gofastr

Links

Open Source Insights

Documentation ¶

Overview ¶

Package skillmd is part of the GoFastr harness.

See docs/harness-architecture.md for the architecture this package implements.

Package skillmd parses SKILL.md files per the open spec at https://agentskills.io/specification.

Frontmatter: YAML between "---" delimiters. Required fields: name (≤64 chars, lowercase + hyphens) and description (≤1024 chars). Optional: triggers (list of strings).

We parse YAML by hand for the tiny subset SKILL.md uses (frontmatter is shallow: scalar strings and string lists).

Index ¶

type Skill
- func Parse(path string) (*Skill, error)
- func ParseBytes(data []byte) (*Skill, error)
- func (s *Skill) Tier1() Tier1
- func (s *Skill) Validate() error
type Tier1

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Skill ¶

type Skill struct {
	Name        string
	Description string
	Triggers    []string
	Body        string            // markdown after frontmatter
	Dir         string            // absolute path to the directory containing SKILL.md
	SHA256      string            // hash of the SKILL.md file for TOFU
	Extra       map[string]string // pass-through frontmatter fields
}

Skill is the parsed representation of a SKILL.md file (tier-1 + tier-2 from the progressive-disclosure model).

func Parse ¶

func Parse(path string) (*Skill, error)

Parse reads a SKILL.md file at the given path.

func ParseBytes ¶

func ParseBytes(data []byte) (*Skill, error)

ParseBytes parses SKILL.md content directly.

func (*Skill) Tier1 ¶

func (s *Skill) Tier1() Tier1

Tier1 returns the lightweight metadata.

func (*Skill) Validate ¶

func (s *Skill) Validate() error

Validate enforces the spec's required-field constraints.

type Tier1 ¶

type Tier1 struct {
	Name        string
	Description string
}

Tier1 returns just the name + description; this is what the loader surfaces at startup (the ~100 tokens/skill cost the spec markets).

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL