skills

Documentation

Overview

Package skills embeds the tier-2 workplace skill (agent work and collaboration; a skill may run from any execution environment — the tier is its purpose, not a location) shipped with the bashy binary, so it resolves from any cwd WITHOUT the source tree present — the skill content is compiled into `bashy`, not read from this repo. Surface it with `bashy skill` (see internal/agentos).

`bashy` is the ONLY installed skill: every bashy command is a skill too (`bashy <cmd> --help` renders it; see internal/agentos/skillhelp.go), so a second top-level skill folder would just be a second way to say the same thing. A front-door command that wants a long-form doc beyond its own generated help adds one under bashy/commands/<cmd>.md (an optional bashy/reference/<cmd>.md companion, and bashy/commands/<cmd>.dhnt for a machine-checkable contract) — still embedded through this one folder, and still reachable as `bashy skill show/run <cmd>` via CommandDoc/CommandNames below bridging those names into the skill catalog (internal/agentos).

Index

• Variables
• func Body(name string) (string, bool)
• func CommandDhnt(name string) (string, bool)
• func CommandDoc(name string) (string, bool)
• func CommandNames() []string
• func CommandReference(name string) (string, bool)
• func Names() []string
• func Reference(name string) (string, bool)

Variables

var FS embed.FS

Functions

func Body

func Body(name string) (string, bool)

Body returns the embedded SKILL.md for a skill, or ("", false) if absent.

func CommandDhnt

func CommandDhnt(name string) (string, bool)

CommandDhnt returns the embedded skill.dhnt companion for a command doc (bashy/commands/<name>.dhnt), if it declares a machine-checkable contract.

func CommandDoc

func CommandDoc(name string) (string, bool)

CommandDoc returns the embedded long-form doc for a front-door command moved into the bashy skill folder (bashy/commands/<name>.md) — the full original skill body, frontmatter included — or ("", false) if the command has none.

func CommandNames

func CommandNames() []string

CommandNames returns the name of every front-door command with a moved doc under bashy/commands (those with a <cmd>.md), sorted.

func CommandReference

func CommandReference(name string) (string, bool)

CommandReference returns the embedded reference.md companion for a command doc (bashy/reference/<name>.md), if it has one.

func Names

func Names() []string

Names returns every embedded skill directory name (those with a SKILL.md), sorted.

func Reference

func Reference(name string) (string, bool)

Reference returns the embedded reference.md for a skill, if it has one.