@framers/agentos-skills 0.2.0 → 0.2.1

package/dist/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * @fileoverview Skills Runtime Types for AgentOS
+ * @module @framers/agentos-skills/types
+ *
+ * Skills are modular capabilities defined in SKILL.md files with
+ * YAML frontmatter specifying metadata, requirements, and install specs.
+ *
+ * This module is adapted from the Wunderland/OpenClaw skills system.
+ */
+/**
+ * Supported package manager/installation methods.
+ */
+export type SkillInstallKind = 'brew' | 'apt' | 'node' | 'go' | 'uv' | 'download';
+/**
+ * Installation specification for a skill dependency.
+ */
+export interface SkillInstallSpec {
+    /** Unique identifier for this install spec */
+    id?: string;
+    /** Installation method */
+    kind: SkillInstallKind;
+    /** Human-readable label */
+    label?: string;
+    /** Binary names that should exist after install */
+    bins?: string[];
+    /** Limit to specific OS platforms */
+    os?: readonly string[];
+    /** Homebrew formula name */
+    formula?: string;
+    /** Package name (apt package, npm package, uv tool package) */
+    package?: string;
+    /** Go module spec for `go install` (e.g. `golang.org/x/tools/cmd/goimports@latest`) */
+    module?: string;
+    /** Download URL */
+    url?: string;
+    /** Archive filename for extraction */
+    archive?: string;
+    /** Whether to extract the archive */
+    extract?: boolean;
+    /** Number of path components to strip during extraction */
+    stripComponents?: number;
+    /** Target directory for extracted files */
+    targetDir?: string;
+}
+/**
+ * Requirements for a skill to be eligible.
+ */
+export interface SkillRequirements {
+    /** All of these binaries must be available */
+    bins?: string[];
+    /** At least one of these binaries must be available */
+    anyBins?: string[];
+    /** Required environment variables */
+    env?: string[];
+    /** Required config paths */
+    config?: string[];
+}
+/**
+ * Skill metadata from SKILL.md frontmatter.
+ */
+export interface SkillMetadata {
+    /** Always include this skill regardless of requirements */
+    always?: boolean;
+    /** Override skill key (default: folder name) */
+    skillKey?: string;
+    /** Primary environment variable for this skill */
+    primaryEnv?: string;
+    /** Emoji for display */
+    emoji?: string;
+    /** Homepage URL */
+    homepage?: string;
+    /** Limit to specific OS platforms */
+    os?: readonly string[];
+    /** Requirements for eligibility */
+    requires?: SkillRequirements;
+    /** Installation specifications */
+    install?: SkillInstallSpec[];
+}
+/**
+ * Policy controlling how a skill can be invoked.
+ */
+export interface SkillInvocationPolicy {
+    /** Whether users can invoke directly via commands */
+    userInvocable: boolean;
+    /** Whether to disable LLM model invocation */
+    disableModelInvocation: boolean;
+}
+/**
+ * Dispatch specification for skill commands.
+ */
+export interface SkillCommandDispatch {
+    /** Dispatch kind (tool invocation) */
+    kind: 'tool';
+    /** Name of the tool to invoke */
+    toolName: string;
+    /** How to forward user-provided args */
+    argMode?: 'raw';
+}
+/**
+ * Command specification for a skill.
+ */
+export interface SkillCommandSpec {
+    /** Command name (e.g., "/github") */
+    name: string;
+    /** Parent skill name */
+    skillName: string;
+    /** Command description */
+    description: string;
+    /** Optional dispatch behavior */
+    dispatch?: SkillCommandDispatch;
+}
+/**
+ * Raw skill definition with name and content.
+ */
+export interface Skill {
+    /** Unique skill name (folder name) */
+    name: string;
+    /** Skill description from frontmatter or first paragraph */
+    description: string;
+    /** Full SKILL.md content (after frontmatter) */
+    content: string;
+}
+/**
+ * Parsed SKILL.md frontmatter.
+ */
+export type ParsedSkillFrontmatter = Record<string, unknown>;
+/**
+ * Complete skill entry with all metadata.
+ */
+export interface SkillEntry {
+    /** Core skill data */
+    skill: Skill;
+    /** Raw frontmatter values */
+    frontmatter: ParsedSkillFrontmatter;
+    /** Parsed AgentOS/Wunderland/OpenClaw metadata */
+    metadata?: SkillMetadata;
+    /** Invocation policy */
+    invocation?: SkillInvocationPolicy;
+    /** Source directory path */
+    sourcePath?: string;
+    /** Optional source tag indicating where the skill was loaded from (e.g., "bundled", "workspace"). */
+    source?: string;
+}
+/**
+ * Context for evaluating skill eligibility.
+ */
+export interface SkillEligibilityContext {
+    /** Current platform(s) */
+    platforms: string[];
+    /** Check if a binary is available */
+    hasBin: (bin: string) => boolean;
+    /** Check if any of the binaries are available */
+    hasAnyBin: (bins: string[]) => boolean;
+    /** Check if an environment variable is set */
+    hasEnv?: (envVar: string) => boolean;
+    /** Additional note for filtering */
+    note?: string;
+}
+/**
+ * Snapshot of skills for agent context.
+ */
+export interface SkillSnapshot {
+    /** Formatted prompt text for LLM */
+    prompt: string;
+    /** List of included skills with names */
+    skills: Array<{
+        name: string;
+        primaryEnv?: string;
+    }>;
+    /** Resolved skills */
+    resolvedSkills?: Skill[];
+    /** Snapshot version */
+    version?: number;
+    /** Created timestamp */
+    createdAt: Date;
+}
+/**
+ * Configuration for skill loading.
+ */
+export interface SkillsLoadConfig {
+    /** Additional skill directories to scan */
+    extraDirs?: string[];
+    /** Watch for changes */
+    watch?: boolean;
+    /** Debounce for watcher (ms) */
+    watchDebounceMs?: number;
+}
+/**
+ * Install preferences for skills.
+ */
+export interface SkillsInstallPreferences {
+    /** Prefer Homebrew when available */
+    preferBrew: boolean;
+    /** Node package manager to use */
+    nodeManager: 'npm' | 'pnpm' | 'yarn' | 'bun';
+}
+/**
+ * Per-skill configuration.
+ */
+export interface SkillConfig {
+    /** Whether the skill is enabled */
+    enabled?: boolean;
+    /** API key for the skill */
+    apiKey?: string;
+    /** Environment variable overrides */
+    env?: Record<string, string>;
+    /** Additional configuration */
+    config?: Record<string, unknown>;
+}
+/**
+ * Top-level skills configuration.
+ */
+export interface SkillsConfig {
+    /** Allowlist for bundled skills */
+    allowBundled?: string[];
+    /** Loading configuration */
+    load?: SkillsLoadConfig;
+    /** Install preferences */
+    install?: SkillsInstallPreferences;
+    /** Per-skill configurations */
+    entries?: Record<string, SkillConfig>;
+}
+/** Maximum length for skill command names */
+export declare const SKILL_COMMAND_MAX_LENGTH = 32;
+/** Fallback command name */
+export declare const SKILL_COMMAND_FALLBACK = "skill";
+/** Maximum length for skill command descriptions (Discord limit) */
+export declare const SKILL_COMMAND_DESCRIPTION_MAX_LENGTH = 100;
+/** Default snapshot version */
+export declare const DEFAULT_SNAPSHOT_VERSION = 1;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Skills Runtime Types for AgentOS
+ * @module @framers/agentos-skills/types
+ *
+ * Skills are modular capabilities defined in SKILL.md files with
+ * YAML frontmatter specifying metadata, requirements, and install specs.
+ *
+ * This module is adapted from the Wunderland/OpenClaw skills system.
+ */
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** Maximum length for skill command names */
+export const SKILL_COMMAND_MAX_LENGTH = 32;
+/** Fallback command name */
+export const SKILL_COMMAND_FALLBACK = 'skill';
+/** Maximum length for skill command descriptions (Discord limit) */
+export const SKILL_COMMAND_DESCRIPTION_MAX_LENGTH = 100;
+/** Default snapshot version */
+export const DEFAULT_SNAPSHOT_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgTH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,4BAA4B;AAC5B,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,oEAAoE;AACpE,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,33 +1,28 @@
 {
   "name": "@framers/agentos-skills",
-  "version": "0.2.0",
-  "description": "Community registry of skills for AgentOS (SKILL.md prompt modules)",
+  "version": "0.2.1",
+  "description": "Skills runtime for AgentOS — loads, parses, and manages SKILL.md prompt modules",
   "type": "module",
   "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./registry.json",
-      "types": "./types.d.ts"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
-    "./registry.json": "./registry.json",
     "./package.json": "./package.json"
   },
   "files": [
-    "registry",
-    "registry.json",
-    "types.d.ts",
+    "dist",
     "README.md"
   ],
-  "scripts": {
-    "validate": "node scripts/validate-skill.mjs"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "keywords": [
     "agentos",
     "skills",
-    "registry",
+    "runtime",
+    "skill-loader",
+    "skill-registry",
     "prompts"
   ],
   "author": {
@@ -39,5 +34,28 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/framersai/agentos-skills.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.12",
+    "typescript": "^5.4.5"
+  },
+  "peerDependencies": {
+    "@framers/agentos": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@framers/agentos": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo"
   }
-}
+}

package/registry/curated/1password/SKILL.md

@@ -1,53 +0,0 @@
----
-name: 1password
-version: '1.0.0'
-description: Query and retrieve items from 1Password vaults using the 1Password CLI for secure credential access.
-author: Wunderland
-namespace: wunderland
-category: security
-tags: [1password, passwords, secrets, vault, credentials, security]
-requires_secrets: []
-requires_tools: []
-metadata:
-  agentos:
-    emoji: "\uD83D\uDD10"
-    primaryEnv: OP_SERVICE_ACCOUNT_TOKEN
-    homepage: https://developer.1password.com/docs/cli
-    requires:
-      bins: ['op']
-    install:
-      - id: brew
-        kind: brew
-        formula: 1password-cli
-        bins: ['op']
-        label: 'Install 1Password CLI (brew)'
----
-
-# 1Password Vault Queries
-
-You can query 1Password vaults to retrieve credentials, secure notes, API keys, and other secrets using the `op` CLI. This enables secure access to stored credentials without hardcoding secrets in code or configuration files.
-
-When retrieving items, use `op item get` with the item name or UUID. Support querying specific fields (username, password, TOTP, custom fields) using the `--fields` flag. For listing items, filter by vault, category (login, secure-note, api-credential, credit-card), or tags. Always use the most specific identifier available to avoid ambiguous matches.
-
-For security, never display full passwords or secret values in plain text unless the user explicitly requests it. Instead, confirm the item exists and describe its metadata (title, vault, category, last modified). When injecting secrets into environment variables or configuration files, use `op run` or `op inject` for ephemeral secret injection that avoids writing secrets to disk.
-
-Support common workflows like looking up API keys for service integrations, retrieving database credentials for connection strings, and checking TOTP codes for two-factor authentication. When multiple items match a query, present a disambiguated list with vault and category context so the user can select the correct one.
-
-## Examples
-
-- "Look up the API key for our Stripe integration"
-- "What vaults do I have access to?"
-- "Get the database connection credentials from the Production vault"
-- "Generate a TOTP code for my AWS account"
-- "List all items tagged 'deploy' in the DevOps vault"
-- "Inject secrets from the 'staging-env' item into environment variables"
-
-## Constraints
-
-- Requires the `op` CLI to be installed and authenticated (service account token or interactive sign-in).
-- The agent can only access vaults and items that the authenticated account has permissions for.
-- Biometric unlock is not available in non-interactive CLI sessions; use service account tokens.
-- TOTP codes are time-sensitive and expire every 30 seconds.
-- Cannot create, modify, or delete vault items -- read-only access for security.
-- Session tokens expire after 30 minutes of inactivity by default.
-- Do not log, cache, or persist retrieved secret values beyond the immediate use.

package/registry/curated/apple-notes/SKILL.md

@@ -1,45 +0,0 @@
----
-name: apple-notes
-version: '1.0.0'
-description: Create, read, search, and manage notes in Apple Notes using AppleScript and macOS automation.
-author: Wunderland
-namespace: wunderland
-category: productivity
-tags: [apple-notes, macos, notes, applescript, automation]
-requires_secrets: []
-requires_tools: [filesystem]
-metadata:
-  agentos:
-    emoji: "\uD83D\uDCF1"
-    os: ['darwin']
-    requires:
-      bins: ['osascript']
----
-
-# Apple Notes Integration
-
-You can create, read, search, and manage notes in Apple Notes on macOS using AppleScript commands executed via `osascript`. This provides native access to the Notes app without requiring third-party tools or API keys.
-
-When creating notes, use `osascript` to invoke AppleScript that creates note entries with title and body text. Notes support basic HTML formatting for bold, italic, lists, and headings. Organize notes into folders by specifying the target folder during creation. If a folder does not exist, create it first before adding notes to it.
-
-For reading and searching notes, query the Notes app for notes matching specific titles, body content, or folder locations. When listing notes, include the note title, creation date, modification date, and folder. For search operations, match against both title and body text. Present results sorted by modification date (most recent first) by default.
-
-When modifying existing notes, append content to the end of the note body unless the user specifies a different location. Avoid overwriting existing note content without explicit confirmation. Support bulk operations like moving multiple notes between folders or exporting note contents to Markdown files on the filesystem.
-
-## Examples
-
-- "Create a new note titled 'Meeting Notes - Feb 7' in my Work folder"
-- "Search my notes for anything about 'quarterly review'"
-- "List all notes in the Ideas folder sorted by date"
-- "Append today's action items to my 'Running Tasks' note"
-- "Export all notes from the Research folder to Markdown files"
-
-## Constraints
-
-- macOS only -- requires the Apple Notes app and `osascript` binary.
-- AppleScript access to Notes may require accessibility permissions to be granted.
-- Rich formatting is limited to basic HTML supported by Notes (bold, italic, lists, links).
-- Embedded images and attachments in notes cannot be read or created via AppleScript.
-- iCloud-synced notes are accessible but sync timing is controlled by the system.
-- Large notes (100KB+) may experience slow AppleScript operations.
-- Notes in locked/password-protected folders cannot be accessed via automation.

package/registry/curated/apple-reminders/SKILL.md

@@ -1,46 +0,0 @@
----
-name: apple-reminders
-version: '1.0.0'
-description: Create, manage, and query reminders and lists in Apple Reminders using AppleScript and macOS automation.
-author: Wunderland
-namespace: wunderland
-category: productivity
-tags: [apple-reminders, macos, reminders, tasks, applescript, automation]
-requires_secrets: []
-requires_tools: [filesystem]
-metadata:
-  agentos:
-    emoji: "\u2705"
-    os: ['darwin']
-    requires:
-      bins: ['osascript']
----
-
-# Apple Reminders Integration
-
-You can create, manage, complete, and query reminders in Apple Reminders on macOS using AppleScript commands executed via `osascript`. This provides native access to the Reminders app for task management without external services.
-
-When creating reminders, specify the title, due date, priority (0=none, 1-4=high, 5=medium, 6-9=low), and target list. If the user does not specify a list, use the default reminders list. Support creating reminders with notes/body text for additional context. For recurring reminders, set the recurrence rule (daily, weekly, monthly) when supported.
-
-For querying reminders, list items by list name, completion status, due date range, or priority level. Present results in a clear format showing title, due date, priority, and completion status. Support filtering incomplete reminders that are overdue. When showing upcoming reminders, sort by due date ascending.
-
-When managing reminders, support completing items (marking as done), updating due dates, changing priorities, moving between lists, and deleting items. For bulk operations, process items efficiently and report results. Create new reminder lists when the user requests organizing tasks into new categories.
-
-## Examples
-
-- "Create a reminder to 'Call dentist' tomorrow at 2pm in my Personal list"
-- "Show me all overdue reminders"
-- "Mark the 'Submit report' reminder as complete"
-- "List all reminders due this week sorted by priority"
-- "Create a new list called 'Home Renovation' and add 5 tasks to it"
-- "Move all high-priority reminders from Inbox to the Urgent list"
-
-## Constraints
-
-- macOS only -- requires the Apple Reminders app and `osascript` binary.
-- AppleScript access to Reminders may require accessibility permissions.
-- Location-based reminders cannot be created via AppleScript.
-- Sub-tasks (nested reminders) have limited AppleScript support.
-- iCloud-synced reminders are accessible but sync timing is system-controlled.
-- Attachments and images on reminders cannot be managed via automation.
-- Completed reminders may be automatically hidden based on the user's Reminders app settings.

package/registry/curated/coding-agent/SKILL.md

@@ -1,40 +0,0 @@
----
-name: coding-agent
-version: '1.0.0'
-description: Write, review, debug, refactor, and explain code across multiple programming languages and frameworks.
-author: Wunderland
-namespace: wunderland
-category: developer-tools
-tags: [coding, programming, code-review, debugging, refactoring, development]
-requires_secrets: []
-requires_tools: [filesystem]
-metadata:
-  agentos:
-    emoji: "\uD83D\uDCBB"
----
-
-# Code Writing and Review Agent
-
-You are a skilled software developer capable of writing, reviewing, debugging, refactoring, and explaining code across a wide range of programming languages and frameworks. Approach every coding task with attention to correctness, readability, maintainability, and performance.
-
-When writing code, always follow the conventions of the target language and framework. Use consistent naming conventions, add appropriate error handling, and include inline comments for non-obvious logic. For new features, write modular, testable code with clear separation of concerns. Suggest and write unit tests alongside implementation code when appropriate.
-
-For code review, analyze code for bugs, security vulnerabilities, performance issues, and style inconsistencies. Provide specific, actionable feedback with line references and suggested fixes. Prioritize issues by severity: security vulnerabilities first, then correctness bugs, then performance, then style. Explain the reasoning behind each suggestion.
-
-When debugging, systematically narrow down the root cause by analyzing error messages, stack traces, and code flow. Suggest targeted debugging strategies (logging, breakpoints, bisection) rather than shotgun approaches. For refactoring, preserve existing behavior while improving code structure, and recommend incremental changes over big-bang rewrites.
-
-## Examples
-
-- "Write a TypeScript function to debounce API calls with a configurable delay"
-- "Review this PR for security issues and suggest improvements"
-- "Debug why this React component re-renders on every keystroke"
-- "Refactor this 200-line function into smaller, testable units"
-- "Explain how this recursive algorithm works step by step"
-
-## Constraints
-
-- Always test suggestions mentally for edge cases before presenting them.
-- Do not introduce dependencies without explaining why they are necessary.
-- Respect existing code style and conventions in the project.
-- For security-sensitive code (auth, crypto, input validation), err on the side of caution and recommend established libraries over custom implementations.
-- Large refactors should be broken into reviewable increments.

package/registry/curated/discord-helper/SKILL.md

@@ -1,43 +0,0 @@
----
-name: discord-helper
-version: '1.0.0'
-description: Manage Discord servers, channels, roles, and messages through the Discord API.
-author: Wunderland
-namespace: wunderland
-category: communication
-tags: [discord, messaging, server, moderation, community]
-requires_secrets: [discord.bot_token]
-requires_tools: []
-metadata:
-  agentos:
-    emoji: "\uD83C\uDFAE"
-    primaryEnv: DISCORD_BOT_TOKEN
-    homepage: https://discord.com/developers
----
-
-# Discord Server Helper
-
-You can interact with Discord servers (guilds) to send messages, manage channels, assign roles, moderate content, and handle events. Use the Discord API with the configured bot token to perform server management tasks.
-
-When sending messages, use Discord's rich embed format for structured content including titles, descriptions, fields, colors, and thumbnails. Respect channel categories and permissions when posting. For moderation tasks, always log actions and provide clear reasons when warning, muting, or banning users.
-
-For server management, you can create and organize channels into categories, set up role hierarchies with appropriate permissions, and configure server settings. When handling voice channels, check user presence before attempting operations. Use threads for focused discussions to keep channels organized.
-
-Manage slash commands and interactions for interactive bot experiences. Handle reaction roles, welcome messages, and automated moderation rules. When dealing with large servers, paginate member lists and message histories efficiently. Always respect Discord's rate limits and retry with exponential backoff when throttled.
-
-## Examples
-
-- "Send an embed to #announcements with the release notes"
-- "Create a new text channel called 'dev-chat' in the Engineering category"
-- "List all members with the 'Moderator' role"
-- "Set up a reaction role message in #roles for team selection"
-- "Purge the last 50 messages in #spam"
-
-## Constraints
-
-- Bot permissions are determined by its role in each server. Common permissions needed: Send Messages, Manage Channels, Manage Roles, Kick/Ban Members.
-- Rate limits: 50 requests/second globally, with per-route limits.
-- Message content intent is required for reading message content in non-DM contexts.
-- Cannot interact with servers the bot has not been invited to.
-- Embeds are limited to 6,000 total characters across all fields.
-- Bulk message deletion only works for messages less than 14 days old.

package/registry/curated/git/SKILL.md

@@ -1,39 +0,0 @@
----
-name: git
-version: '1.0.0'
-description: Work with Git repositories from the command line.
-author: Wunderland
-namespace: wunderland
-category: developer-tools
-tags: [git, version-control, vcs, branching, commits]
-requires_secrets: []
-requires_tools: []
-metadata:
-  agentos:
-    emoji: '🧰'
-    requires:
-      bins: ['git']
-    install:
-      - id: brew
-        kind: brew
-        formula: git
-        bins: ['git']
-        label: 'Install git (brew)'
-      - id: apt
-        kind: apt
-        package: git
-        bins: ['git']
-        os: ['linux']
-        label: 'Install git (apt)'
----
-
-# Git
-
-Use `git` to inspect history, create branches, commit changes, and resolve conflicts.
-
-## Common workflows
-
-- Check status: `git status`
-- Create a branch: `git checkout -b my-branch`
-- Stage + commit: `git add -A && git commit -m "message"`
-- Rebase: `git rebase -i origin/main`

package/registry/curated/github/SKILL.md

@@ -1,54 +0,0 @@
----
-name: github
-version: '1.0.0'
-description: Manage GitHub repositories, issues, pull requests, releases, and Actions workflows using the gh CLI.
-author: Wunderland
-namespace: wunderland
-category: developer-tools
-tags: [github, git, issues, pull-requests, ci-cd, code-review]
-requires_secrets: [github.token]
-requires_tools: []
-metadata:
-  agentos:
-    emoji: "\uD83D\uDC19"
-    primaryEnv: GITHUB_TOKEN
-    requires:
-      bins: ['gh']
-    install:
-      - id: brew
-        kind: brew
-        formula: gh
-        bins: ['gh']
-        label: 'Install GitHub CLI (brew)'
-      - id: apt
-        kind: apt
-        package: gh
-        bins: ['gh']
-        os: ['linux']
-        label: 'Install GitHub CLI (apt)'
----
-
-# GitHub (gh CLI)
-
-Use the `gh` CLI to interact with GitHub repositories, issues, pull requests, releases, and GitHub Actions. You have full access to the GitHub API through the CLI, which supports both interactive and scriptable workflows.
-
-When managing issues, always check for existing duplicates before creating new ones. For pull requests, include a clear title and description summarizing the changes. When reviewing PRs, provide specific, actionable feedback referencing line numbers. Use labels and milestones to organize work when the repository supports them.
-
-For repository operations, prefer `gh api` for advanced queries that the standard subcommands do not cover. You can use `gh api graphql` for complex queries involving nested relationships. Always verify authentication status with `gh auth status` before performing write operations.
-
-When working with GitHub Actions, you can trigger workflows with `gh workflow run`, check run status with `gh run list`, and view logs with `gh run view --log`. Use `gh release create` to manage releases with proper semantic versioning and changelogs.
-
-## Examples
-
-- `gh issue list --label bug --state open`
-- `gh pr create --title "Fix auth bug" --body "Resolves #42"`
-- `gh pr review 123 --approve`
-- `gh api repos/{owner}/{repo}/actions/runs --jq '.workflow_runs[:5]'`
-- `gh release create v1.2.0 --generate-notes`
-
-## Constraints
-
-- Requires the `gh` CLI to be installed and authenticated.
-- Write operations require appropriate repository permissions.
-- API rate limits apply (5,000 requests/hour for authenticated users).
-- Large file operations should use Git LFS rather than the GitHub API.