installer

Documentation

Overview

Package installer downloads and extracts skill packages distributed as .zip or .tar.gz archives. The result must validate against ADK's SKILL.md frontmatter rules; otherwise the install is aborted and nothing lands in the user's skills directory.

Why URL+archive only (no git): keeps the dependency surface to stdlib, avoids requiring `git` in PATH, and matches how most agent skill catalogues already distribute (GitHub release zips, tar.gz from a static host). Users who want to install from a git repo can reach for `git archive` and point us at the resulting tarball.

Index

• func Install(ctx context.Context, sourceURL, destBase string) (string, error)

Functions

func Install

func Install(ctx context.Context, sourceURL, destBase string) (string, error)

Install fetches sourceURL, detects whether the payload is a .zip or .tar.gz, extracts it to a temp directory, validates that the result contains a SKILL.md with a valid frontmatter, and then atomically renames the temp directory into destBase/<skill-name>.

The skill name is taken from the parsed frontmatter; the original archive's directory name is ignored. This way an archive that extracts to "my-skill-main/" (the common GitHub release pattern) lands as "my-skill/" on disk.

Returns the installed skill name on success, or an error and leaves destBase untouched on any failure.