From 5542ea53b2a9fc64ee13cd2cac06ac5c4f0f4914 Mon Sep 17 00:00:00 2001 From: Doug Richar Date: Tue, 10 Feb 2026 06:38:31 -0500 Subject: [PATCH 1/5] fix: update copyright year and align skill-creator description Update LICENSE copyright to 2026. Make the skill-creator SKILL.md description agent-agnostic (was Claude-specific) and align the README table to match. Co-Authored-By: Claude Opus 4.6 --- LICENSE | 2 +- README.md | 2 +- skills/skill-creator/SKILL.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/LICENSE b/LICENSE index 7a74473..150eaa4 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2025 TxnLab +Copyright (c) 2026 TxnLab Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index ec32e95..d2c5c8c 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ That's it. The `nfd` skill is now available to your AI agent. | `nfd` | Work with NFDomains, the Algorand Name Service for .algo domains | | `use-wallet` | Integrate Algorand wallet connections with @txnlab/use-wallet | | `haystack-router` | Route and execute optimal swaps on Algorand DEXes via Haystack | -| `skill-creator` | Create new Agent Skills following the Agent Skills specification | +| `skill-creator` | Guide for creating effective Agent Skills following the spec | ## CLI Reference diff --git a/skills/skill-creator/SKILL.md b/skills/skill-creator/SKILL.md index 1589797..53447f4 100644 --- a/skills/skill-creator/SKILL.md +++ b/skills/skill-creator/SKILL.md @@ -1,6 +1,6 @@ --- name: skill-creator -description: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations. +description: Guide for creating effective Agent Skills following the Agent Skills specification. Use when creating a new skill (or updating an existing skill) that extends an AI coding agent's capabilities with specialized knowledge, workflows, or tool integrations. license: Complete terms in LICENSE.txt --- From df2dd3530f6506678891002801fa765c460ceca8 Mon Sep 17 00:00:00 2001 From: Doug Richar Date: Tue, 10 Feb 2026 06:39:23 -0500 Subject: [PATCH 2/5] docs(readme): document undocumented CLI flags and add command matrix Add --force flag to dev commands section and flags table. Add --agent and --local examples to the remove command section. Expand the flags table with a Commands column showing which flags apply to which commands. Co-Authored-By: Claude Opus 4.6 --- README.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index d2c5c8c..21aa375 100644 --- a/README.md +++ b/README.md @@ -61,6 +61,8 @@ npx @txnlab/skills add nfd --local # Install to project-level directory ```bash npx @txnlab/skills remove npx @txnlab/skills remove --all +npx @txnlab/skills remove nfd -a claude-code # Target specific agent +npx @txnlab/skills remove nfd --local # Remove from project-level directory ``` ### Validate skills @@ -75,20 +77,22 @@ npx @txnlab/skills validate # Validate one ```bash npx @txnlab/skills dev link # Symlink skill for local dev npx @txnlab/skills dev link --all # Symlink all skills +npx @txnlab/skills dev link nfd --force # Overwrite existing non-symlink target npx @txnlab/skills dev unlink --all # Remove dev symlinks ``` ### Flags -| Flag | Description | -| --------------------- | ------------------------------------------- | -| `-a, --agent ` | Target specific agent (repeatable) | -| `-g, --global` | Install to global skill directory (default) | -| `-l, --local` | Install to project-level skill directory | -| `--all` | Apply to all skills | -| `-y, --yes` | Skip confirmation prompts | -| `-v, --version` | Show version | -| `-h, --help` | Show help | +| Flag | Commands | Description | +| --------------------- | --------------------- | ---------------------------------------------- | +| `-a, --agent ` | add, remove, dev | Target specific agent (repeatable) | +| `-g, --global` | add, remove | Use global skill directory (default) | +| `-l, --local` | add, remove | Use project-level skill directory | +| `--all` | add, remove, dev | Apply to all skills | +| `--force` | dev link | Overwrite existing non-symlink targets | +| `-y, --yes` | remove | Skip confirmation prompts | +| `-v, --version` | (global) | Show version | +| `-h, --help` | (all) | Show help | ## Installation From 11abc585ab1646decbe2a016888a7d3a9b3826b1 Mon Sep 17 00:00:00 2001 From: Doug Richar Date: Tue, 10 Feb 2026 06:40:34 -0500 Subject: [PATCH 3/5] docs: add Node.js prereq, Quick Start fallback, and minor fixes Add Node.js >= 18 requirement to Installation section. Add --agent fallback example to Quick Start for users without auto-detected agents. Add OpenCode to AGENTS.md agent list. Add README cross-reference to CLAUDE.md. Clarify the double-dev command in Local Development section. Co-Authored-By: Claude Opus 4.6 --- AGENTS.md | 2 +- CLAUDE.md | 2 ++ README.md | 12 +++++++++--- 3 files changed, 12 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 2547086..cdccc87 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # Contributing Agent Instructions -Instructions for AI agents (Claude Code, Codex, Cursor) contributing to this repo. +Instructions for AI agents (Claude Code, Codex, Cursor, OpenCode) contributing to this repo. ## Repository Structure diff --git a/CLAUDE.md b/CLAUDE.md index d5cf64c..f728670 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -27,3 +27,5 @@ bun run validate # Validate all SKILL.md files - Tests use `bun:test`, test files go in `tests/` - Commit messages follow conventional commits - Bun is the only runtime — do not use npm/yarn/pnpm + +See `README.md` for the full CLI reference, supported agents, and contributing guide. diff --git a/README.md b/README.md index 21aa375..3f96129 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,11 @@ Skills are reusable instruction packages that extend AI coding agents (Claude Co npx @txnlab/skills add nfd ``` -That's it. The `nfd` skill is now available to your AI agent. +That's it. The `nfd` skill is now available to your AI agent. If no agent is auto-detected, specify one with `--agent`: + +```bash +npx @txnlab/skills add nfd --agent claude-code +``` ## Available Skills @@ -96,6 +100,8 @@ npx @txnlab/skills dev unlink --all # Remove dev symlinks ## Installation +Requires Node.js >= 18. + ### Via npx (recommended) ```bash @@ -132,10 +138,10 @@ cd skills # Install dependencies bun install -# Symlink all skills for testing +# Symlink all skills for testing ("bun run dev" runs the CLI from source) bun run dev dev link --all -# Edit skills — changes are picked up by Claude Code immediately +# Edit skills — changes are picked up immediately via symlinks # Validate your work bun run dev validate From d25126050fc1ea2559abd0f40f38dae77a4eb15e Mon Sep 17 00:00:00 2001 From: Doug Richar Date: Tue, 10 Feb 2026 06:40:59 -0500 Subject: [PATCH 4/5] chore: add homepage field to package.json Adds homepage URL for better npm discoverability. Co-Authored-By: Claude Opus 4.6 --- package.json | 1 + 1 file changed, 1 insertion(+) diff --git a/package.json b/package.json index 6cba007..cf2677e 100644 --- a/package.json +++ b/package.json @@ -24,6 +24,7 @@ "provenance": true }, "license": "MIT", + "homepage": "https://github.com/TxnLab/skills#readme", "repository": { "type": "git", "url": "git+https://github.com/TxnLab/skills.git" From ab7a4db399bdff5422169c5040ace85110cc4ce0 Mon Sep 17 00:00:00 2001 From: Doug Richar Date: Tue, 10 Feb 2026 06:41:34 -0500 Subject: [PATCH 5/5] style(readme): fix Prettier formatting in flags table Co-Authored-By: Claude Opus 4.6 --- README.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 3f96129..6d037dc 100644 --- a/README.md +++ b/README.md @@ -87,16 +87,16 @@ npx @txnlab/skills dev unlink --all # Remove dev symlinks ### Flags -| Flag | Commands | Description | -| --------------------- | --------------------- | ---------------------------------------------- | -| `-a, --agent ` | add, remove, dev | Target specific agent (repeatable) | -| `-g, --global` | add, remove | Use global skill directory (default) | -| `-l, --local` | add, remove | Use project-level skill directory | -| `--all` | add, remove, dev | Apply to all skills | -| `--force` | dev link | Overwrite existing non-symlink targets | -| `-y, --yes` | remove | Skip confirmation prompts | -| `-v, --version` | (global) | Show version | -| `-h, --help` | (all) | Show help | +| Flag | Commands | Description | +| --------------------- | ---------------- | -------------------------------------- | +| `-a, --agent ` | add, remove, dev | Target specific agent (repeatable) | +| `-g, --global` | add, remove | Use global skill directory (default) | +| `-l, --local` | add, remove | Use project-level skill directory | +| `--all` | add, remove, dev | Apply to all skills | +| `--force` | dev link | Overwrite existing non-symlink targets | +| `-y, --yes` | remove | Skip confirmation prompts | +| `-v, --version` | (global) | Show version | +| `-h, --help` | (all) | Show help | ## Installation