Skip to content

Add installable agent skill for skills.sh - #55

Merged
andreagrandi merged 1 commit into
masterfrom
agent-skill
Jun 7, 2026
Merged

Add installable agent skill for skills.sh#55
andreagrandi merged 1 commit into
masterfrom
agent-skill

Conversation

@andreagrandi

Copy link
Copy Markdown
Owner

Summary

Ships a canonical, public logbasset agent skill at skills/logbasset/SKILL.md, installable via skills.sh (npx skills add andreagrandi/logbasset). The goal is to encourage users to install the skill alongside the binary so their coding agent knows when and how to reach for the CLI.

Design

The skill is intentionally a thin pointer, not a copy of the docs:

  • It does not restate commands or flags. Its runtime workflow is: check the binary is on PATH, then run logbasset context (authoritative reference) and logbasset schema <command> (exact flags) before composing a query.
  • Because nothing in it is flag- or command-specific, a CLI change can never make it stale, and it stays out of the existing per-flag doc-sync checklist.
  • Written in agent-neutral voice (no assumptions about a specific agent), since skills.sh installs to many agents (Claude Code, Codex, Cursor, and others).
  • Includes a binary-presence preflight — the one thing the skill must own, since a missing binary can't be discovered by running logbasset context.

Changes

  • skills/logbasset/SKILL.md — new skill (pure pointer, delegates to logbasset context / logbasset schema).
  • README.md — "Use with AI Coding Agents" section with the install command.
  • CHANGELOG.md[Unreleased] entry.
  • AGENTS.md — note exempting the skill from the per-flag doc-sync checklist so contributors don't reintroduce drift.
  • .gitignore — anchor the logbasset binary pattern to the repo root (/logbasset) so it no longer matches the skills/logbasset/ directory. The root and bin/ binaries remain ignored.

Validation

npx skills add . --list discovers exactly one skill (logbasset) with the expected description, confirming the SKILL.md frontmatter is well-formed.

Ship a canonical, public logbasset skill at skills/logbasset/SKILL.md so
coding agents know when and how to use the CLI. The skill is intentionally
generic: it delegates to `logbasset context` and `logbasset schema` at runtime
rather than restating commands or flags, so a CLI change can never make it
stale.

- README: "Use with AI Coding Agents" section documenting `npx skills add`.
- CHANGELOG: [Unreleased] entry.
- AGENTS.md: note exempting the skill from the per-flag doc-sync checklist.
- .gitignore: anchor the `logbasset` binary pattern to the repo root so it
  stops matching the skills/logbasset/ directory.
@andreagrandi
andreagrandi merged commit 2ca4e3a into master Jun 7, 2026
7 checks passed
@andreagrandi
andreagrandi deleted the agent-skill branch June 7, 2026 20:41
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