@devxiyang/agent-skill 0.0.1

package/dist/discovery/frontmatter.js

@@ -0,0 +1,123 @@
+import matter from 'gray-matter';
+/**
+ * Parses the YAML frontmatter of a SKILL.md file into a normalized structure.
+ *
+ * Supports two requirement sources:
+ * 1. Top-level `requires` field: `bin:git,env:GITHUB_TOKEN`
+ * 2. `metadata` field: a JSON string with a namespaced object (`octoii` or `openclaw`)
+ *    containing `requires`, `bins`, `env`, and `os` keys.
+ *
+ * Values from both sources are merged and deduplicated.
+ */
+export function parseFrontmatter(content) {
+    const { data, content: body } = matter(content);
+    void body;
+    const meta = parseMetadataJson(data.metadata);
+    const requires = extractRequirements(data, meta);
+    return {
+        name: normalizeString(data.name),
+        description: normalizeString(data.description),
+        always: data.always === true || meta.always === true,
+        tags: parseCsv(data.tags ?? meta.tags),
+        requiresBins: requires.bins,
+        requiresEnvs: requires.envs,
+        requiresOs: parseCsv(meta.os),
+    };
+}
+/**
+ * Strips the frontmatter block from a SKILL.md file and returns the trimmed body.
+ * This is the markdown content passed to the agent as skill instructions.
+ */
+export function stripFrontmatter(content) {
+    return matter(content).content.trim();
+}
+// ---------------------------------------------------------------------------
+/**
+ * Parses the `metadata` field, which is an embedded JSON string that may contain
+ * a scoped namespace (`octoii` or `openclaw`). Returns an empty object on failure.
+ */
+function parseMetadataJson(raw) {
+    if (typeof raw !== 'string')
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (!isRecord(parsed))
+            return {};
+        return pickScopedNamespace(parsed);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * If the object has a known namespace key (`octoii`, `openclaw`), returns that
+ * nested object. Otherwise returns the object as-is for flat metadata structures.
+ */
+function pickScopedNamespace(input) {
+    for (const ns of ['octoii', 'openclaw']) {
+        if (ns in input && isRecord(input[ns])) {
+            return input[ns];
+        }
+    }
+    return input;
+}
+/**
+ * Merges `requires` strings and explicit `bins`/`env` lists from both the
+ * top-level frontmatter and the metadata namespace, deduplicating results.
+ */
+function extractRequirements(data, meta) {
+    const bins = new Set();
+    const envs = new Set();
+    for (const { b, e } of [
+        parseRequireString(data.requires),
+        parseRequireString(meta.requires),
+    ]) {
+        b.forEach((v) => bins.add(v));
+        e.forEach((v) => envs.add(v));
+    }
+    parseCsv(meta.bins).forEach((v) => bins.add(v));
+    parseCsv(meta.env).forEach((v) => envs.add(v));
+    return { bins: [...bins], envs: [...envs] };
+}
+/**
+ * Parses a `requires` string of the form `bin:git,env:TOKEN` into separate
+ * bin and env arrays. Supports both comma and semicolon as delimiters.
+ */
+function parseRequireString(raw) {
+    if (typeof raw !== 'string')
+        return { b: [], e: [] };
+    const b = [];
+    const e = [];
+    for (const part of raw.split(/[;,]/)) {
+        const v = part.trim();
+        if (v.startsWith('bin:'))
+            b.push(v.slice(4).trim());
+        else if (v.startsWith('env:'))
+            e.push(v.slice(4).trim());
+    }
+    return { b, e };
+}
+/**
+ * Parses a value that may be a comma-separated string or an array of strings.
+ * Returns an empty array for any other type.
+ */
+function parseCsv(raw) {
+    if (typeof raw === 'string') {
+        return raw.split(',').map((v) => v.trim()).filter(Boolean);
+    }
+    if (Array.isArray(raw)) {
+        return raw.filter((v) => typeof v === 'string');
+    }
+    return [];
+}
+/** Returns the trimmed string, or null if it is empty or not a string. */
+function normalizeString(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const v = raw.trim();
+    return v.length > 0 ? v : null;
+}
+function isRecord(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/discovery/frontmatter.js.map

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

package/dist/discovery/index.d.ts

@@ -0,0 +1,4 @@
+export { SkillDiscovery } from './discovery.js';
+export { parseFrontmatter } from './frontmatter.js';
+export type { SkillFrontmatter } from './frontmatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,3 @@
+export { SkillDiscovery } from './discovery.js';
+export { parseFrontmatter } from './frontmatter.js';
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { SkillEntry, SkillRoot, SkillScope, SkillMissingReason, SkillMissingReasonKind } from './types.js';
+export type { SkillValidator } from './validator.js';
+export { SkillDiscovery, parseFrontmatter } from './discovery/index.js';
+export type { SkillFrontmatter } from './discovery/index.js';
+export { builtinSkillsRoot } from './builtin.js';
+export { defaultValidator } from './validators/index.js';
+export { copySkills } from './copy.js';
+export type { CopySkillsOptions, CopySkillsResult } from './copy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAChH,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { SkillDiscovery, parseFrontmatter } from './discovery/index.js';
+export { builtinSkillsRoot } from './builtin.js';
+export { defaultValidator } from './validators/index.js';
+export { copySkills } from './copy.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+/** Whether a skill came from a user-managed directory or a system-provided one. */
+export type SkillScope = 'user' | 'system';
+/** A directory root that SkillDiscovery scans for skill folders. */
+export type SkillRoot = {
+    /** Absolute path to the directory containing skill subfolders. */
+    path: string;
+    /** Metadata tag for the origin of skills found in this root. Does not affect priority. */
+    scope: SkillScope;
+};
+/** The category of an unmet dependency. */
+export type SkillMissingReasonKind = 'bin' | 'env' | 'os' | 'invalid';
+/** Describes a single unmet requirement that makes a skill ineligible. */
+export type SkillMissingReason = {
+    kind: SkillMissingReasonKind;
+    /** The specific value that failed the check (e.g. binary name, env var name). */
+    value: string;
+    /** Human-readable explanation shown to the user. */
+    message: string;
+};
+/** A discovered skill with its metadata and eligibility status. */
+export type SkillEntry = {
+    /** Display name from frontmatter, or the folder name if not set. */
+    name: string;
+    description: string | null;
+    /** Absolute path to the skill folder. */
+    path: string;
+    /** Absolute path to the SKILL.md file inside the skill folder. */
+    filePath: string;
+    scope: SkillScope;
+    /** True when all requires/os constraints are satisfied in the current environment. */
+    eligible: boolean;
+    /** Unmet requirements; empty when eligible is true. */
+    missing: SkillMissingReason[];
+    /** When true, this skill should be injected into every agent run automatically. */
+    always: boolean;
+    tags: string[];
+};
+//# 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":"AAAA,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3C,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG;IACtB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG;IACvB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pluggable interface for environment dependency checks.
+ * Implement this to replace the default Node.js-based checks with
+ * custom logic (e.g. Electron shell lookups, mocked environments in tests).
+ */
+export interface SkillValidator {
+    /** Returns true if the named executable is available in the current environment. */
+    checkBin(name: string): Promise<boolean>;
+    /** Returns true if the named environment variable is set to a non-empty value. */
+    checkEnv(name: string): boolean;
+    /** Returns true if the current OS matches at least one of the given platform strings. */
+    checkOs(platforms: string[]): boolean;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,yFAAyF;IACzF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CACvC"}

package/dist/validator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":""}

package/dist/validators/index.d.ts

@@ -0,0 +1,2 @@
+export { defaultValidator } from './node.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/validators/index.js

@@ -0,0 +1,2 @@
+export { defaultValidator } from './node.js';
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/validators/node.d.ts

@@ -0,0 +1,9 @@
+import type { SkillValidator } from '../validator.js';
+/**
+ * Default SkillValidator for Node.js environments.
+ * - checkBin: walks PATH segments and probes for the executable via fs.access
+ * - checkEnv: reads process.env
+ * - checkOs: compares against process.platform
+ */
+export declare const defaultValidator: SkillValidator;
+//# sourceMappingURL=node.d.ts.map

package/dist/validators/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/validators/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAkC9B,CAAC"}

package/dist/validators/node.js

@@ -0,0 +1,43 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Default SkillValidator for Node.js environments.
+ * - checkBin: walks PATH segments and probes for the executable via fs.access
+ * - checkEnv: reads process.env
+ * - checkOs: compares against process.platform
+ */
+export const defaultValidator = {
+    /**
+     * Checks whether a binary exists somewhere on PATH.
+     * On Windows, also probes .exe / .cmd / .bat extensions.
+     */
+    async checkBin(name) {
+        const pathEnv = process.env.PATH;
+        if (!pathEnv)
+            return false;
+        const segments = pathEnv.split(path.delimiter).filter(Boolean);
+        const candidates = process.platform === 'win32'
+            ? [name, `${name}.exe`, `${name}.cmd`, `${name}.bat`]
+            : [name];
+        for (const seg of segments) {
+            for (const candidate of candidates) {
+                try {
+                    await fs.access(path.join(seg, candidate));
+                    return true;
+                }
+                catch { /* not found in this segment, continue */ }
+            }
+        }
+        return false;
+    },
+    /** Returns true if the env var exists and is not blank. */
+    checkEnv(name) {
+        const v = process.env[name];
+        return typeof v === 'string' && v.trim().length > 0;
+    },
+    /** Returns true if process.platform is in the allowed list. */
+    checkOs(platforms) {
+        return platforms.includes(process.platform);
+    },
+};
+//# sourceMappingURL=node.js.map

package/dist/validators/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/validators/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QACjC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,UAAU,GACd,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC1B,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC;YACrD,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACb,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;oBAC3C,OAAO,IAAI,CAAC;gBACd,CAAC;gBAAC,MAAM,CAAC,CAAC,yCAAyC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2DAA2D;IAC3D,QAAQ,CAAC,IAAY;QACnB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,+DAA+D;IAC/D,OAAO,CAAC,SAAmB;QACzB,OAAO,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@devxiyang/agent-skill",
+  "version": "0.0.1",
+  "description": "SDK for skill discovery and registration — integrates into any agent",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devxiyang/agent.skill.git"
+  },
+  "keywords": [
+    "agent",
+    "skill",
+    "skill-discovery",
+    "skill-registry",
+    "llm",
+    "sdk",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@types/node": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3"
+  }
+}

package/skills/git/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: git
+description: Local git operations — branching, committing, merging, rebasing, history inspection, and conflict resolution.
+requires: bin:git
+---
+
+# Git Skill
+
+## Common workflow
+
+```bash
+git status
+git diff
+git add <files>
+git commit -m "message"
+```
+
+## Branching
+
+```bash
+git checkout -b feature/name
+git switch main
+git branch -d feature/name
+```
+
+## Inspecting history
+
+```bash
+git log --oneline -20
+git log --oneline --graph --all
+git show <commit>
+git diff main...HEAD
+```
+
+## Undoing changes
+
+```bash
+# Unstage
+git restore --staged <file>
+
+# Discard working tree changes
+git restore <file>
+
+# Undo last commit (keep changes staged)
+git reset --soft HEAD~1
+
+# Interactive rebase to edit recent commits
+git rebase -i HEAD~3
+```
+
+## Stashing
+
+```bash
+git stash push -m "description"
+git stash list
+git stash pop
+```
+
+## Merging & rebasing
+
+```bash
+# Merge
+git merge feature/name
+
+# Rebase onto main
+git rebase main
+
+# Abort on conflict
+git rebase --abort
+git merge --abort
+```
+
+## Conflict resolution
+
+1. Open conflicting files, look for `<<<<<<<` markers
+2. Edit to desired state
+3. `git add <resolved-file>`
+4. `git rebase --continue` or `git merge --continue`
+
+## Remotes
+
+```bash
+git remote -v
+git fetch origin
+git pull --rebase
+git push -u origin HEAD
+```

package/skills/github/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: github
+description: Interact with GitHub using the `gh` CLI. Use for issues, pull requests, CI runs, code review, and GitHub API queries.
+requires: bin:gh
+---
+
+# GitHub Skill
+
+Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` when not inside a git directory.
+
+## Pull Requests
+
+```bash
+# List open PRs
+gh pr list --repo owner/repo
+
+# Check CI status
+gh pr checks <number> --repo owner/repo
+
+# View failed logs
+gh run view <run-id> --repo owner/repo --log-failed
+
+# Review and approve
+gh pr review <number> --approve --repo owner/repo
+```
+
+## Issues
+
+```bash
+# List issues
+gh issue list --repo owner/repo --state open
+
+# Create issue
+gh issue create --title "Title" --body "Body" --repo owner/repo
+
+# Close issue
+gh issue close <number> --repo owner/repo
+```
+
+## API
+
+Use `gh api` for data not available via subcommands:
+
+```bash
+gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
+```
+
+## JSON Output
+
+Most commands support `--json` + `--jq`:
+
+```bash
+gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
+```

package/skills/skill-creator/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: skill-creator
+description: Create or update skills. Use when designing, structuring, or writing a new skill folder with SKILL.md and optional resources.
+---
+
+# Skill Creator
+
+## What is a skill
+
+A skill is a folder that extends an agent's capabilities with specialized knowledge and workflows:
+
+```
+skill-name/
+├── SKILL.md          # required — frontmatter + instructions
+├── scripts/          # optional — executable scripts
+├── references/       # optional — docs loaded on demand
+└── assets/           # optional — templates, images, files used in output
+```
+
+## SKILL.md structure
+
+```markdown
+---
+name: skill-name
+description: What this skill does and when to use it. Be specific about triggers.
+requires: bin:tool,env:API_KEY   # optional
+os: darwin,linux                  # optional, omit for all platforms
+---
+
+# Skill Name
+
+Instructions for the agent...
+```
+
+Only `name` and `description` are required in frontmatter.
+
+## Writing good descriptions
+
+The description is the primary trigger. Include:
+- What the skill does
+- When to use it (specific contexts and phrases that should trigger it)
+
+Example: `"Create and edit .docx files with tracked changes support. Use when working with Word documents, professional reports, or any .docx task."`
+
+## Body guidelines
+
+- Write for another agent instance — include what would be non-obvious
+- Prefer concise examples over verbose explanations
+- Keep under 500 lines; move details to `references/` files
+- Link to reference files explicitly so the agent knows they exist
+
+## Resource types
+
+**scripts/** — Deterministic code run repeatedly. Test each script before including.
+
+**references/** — Docs loaded on demand. Keep SKILL.md lean; put schemas, API docs, and detailed guides here. Reference them from SKILL.md with a note on when to load.
+
+**assets/** — Files used in output (templates, images, fonts). Not loaded into context.
+
+## Progressive disclosure
+
+Three loading levels:
+1. **Name + description** — always in context (~100 tokens)
+2. **SKILL.md body** — loaded when skill triggers (<5k tokens)
+3. **references/ and scripts/** — loaded or executed on demand
+
+Design each level to be independently useful.
+
+## Naming
+
+- Lowercase, hyphens only: `my-skill`, `gh-review`, `pdf-editor`
+- Short and action-oriented
+- Namespace by tool when helpful: `gh-address-comments`