core

type Adapter interface {
	// Name returns the adapter identifier (e.g., "claude", "codex").
	Name() string

	// SkillFileName returns the skill definition filename (e.g., "SKILL.md").
	SkillFileName() string

	// DefaultDir returns the default directory name for skills.
	DefaultDir() string

	// Parse converts tool-specific bytes to canonical Skill.
	Parse(data []byte) (*Skill, error)

	// Marshal converts canonical Skill to tool-specific bytes.
	Marshal(skill *Skill) ([]byte, error)

	// ReadFile reads from path and returns canonical Skill.
	ReadFile(path string) (*Skill, error)

	// WriteFile writes canonical Skill to path.
	WriteFile(skill *Skill, path string) error

	// WriteSkillDir writes the complete skill directory structure.
	WriteSkillDir(skill *Skill, baseDir string) error
}

type MarshalError struct {
	Format string
	Err    error
}

type ParseError struct {
	Format string
	Path   string
	Err    error
}

type ReadError struct {
	Path string
	Err  error
}

type Registry struct {
	// contains filtered or unexported fields
}

type Skill struct {
	// Metadata
	Name        string `json:"name"`
	Description string `json:"description"`

	// Content
	Instructions string `json:"instructions"` // The skill instructions/prompt

	// Resources - paths relative to skill directory
	Scripts    []string `json:"scripts,omitempty"`    // Executable scripts
	References []string `json:"references,omitempty"` // Reference documentation
	Assets     []string `json:"assets,omitempty"`     // Templates, config files

	// Invocation
	Triggers []string `json:"triggers,omitempty"` // Keywords that invoke this skill

	// Dependencies
	Dependencies []string `json:"dependencies,omitempty"` // Required CLI tools
}

type WriteError struct {
	Path string
	Err  error
}