Skip to content

docs(skills): add installer skill#1059

Open
coolaj86 wants to merge 4 commits intomainfrom
doc-installer-skill
Open

docs(skills): add installer skill#1059
coolaj86 wants to merge 4 commits intomainfrom
doc-installer-skill

Conversation

@coolaj86
Copy link
Copy Markdown
Member

Summary

  • Adds _skills/installer/ following the agentskills.io spec
  • Documents the full workflow for creating install.sh and install.ps1 for a new webi package
  • Covers 9 archive layout patterns (A–I) discovered from inspecting 60+ packages

Contents

  • SKILL.md — main skill file: discovery workflow, pattern picker, script skeletons for both POSIX and PowerShell, classification checklist
  • references/PATTERNS.md — detailed install.sh/ps1 skeletons for all 9 patterns with real package examples
  • references/ARCHIVE-LAYOUTS.md — actual tar -t output for representative packages in each pattern
  • references/CLASSIFICATION.md — when to add variant tags, canonical OS/arch/libc/ext vocabulary, asset filter config

What's not included (yet)

  • Writing releases.js / releases.conf (separate skill)
  • Writing Go classification code (separate skill)
  • README.md cheat sheet format

Test plan

  • Review SKILL.md for accuracy against existing install.sh files
  • Confirm pattern examples match actual packages in the repo
  • Verify canonical vocabulary matches what the Go rewrite produces

Covers the full workflow: inspect GitHub releases API to discover archive
layout, choose from 9 patterns (A-I), write POSIX shell and PowerShell
scripts, and identify classification/variant issues.

Reference files:
- PATTERNS.md: install.sh/ps1 skeletons for all 9 patterns
- ARCHIVE-LAYOUTS.md: real tar -t output for representative packages
- CLASSIFICATION.md: when to add variant tags, canonical vocab
- Add __init_pkgname() wrapper as canonical install.sh structure
- Correct WEBI_SINGLE: linking strategy, not archive flatness
- Document pkg_src_bin/pkg_dst_bin as framework-derived (not set manually)
- Fix single-quoted glob bug in zsh completion check
- Add scope note: releases.js is a separate concern
- Explain why install.ps1 is self-contained (no PowerShell framework)
- Add Pattern D reference in skeletons section
- Clarify Pattern A vs F distinction
- Add completion dir name caveat to Pattern C skeleton
- Fix same single-quoted glob bug in PATTERNS.md rg example
- Move set -e/set -u inside __init_ (matches _example canonical form)
- Fix PS1 framework claim: template exists, provides helpers, but package
  script must download and extract itself
- Fix WEBI_SINGLE description: linking strategy, not default-deps rule
- Fix Pattern G pkg_link to use $pkg_src instead of $pkg_src_dir
- Fix Pattern H skeleton to match real pwsh (no bin/ subdir, uses pkg_link)
- Fix Pattern A WEBI_SINGLE description in PATTERNS.md
- Remove goreleaser from Pattern C representative list (it's Pattern A layout)
- Drop goreleaser man page from Pattern C man page location list
- Remove Python snippet from ARCHIVE-LAYOUTS.md zst inspection (use zstd -dc)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant