@softspark/ai-toolkit 3.4.0 → 3.5.0

package/app/skills/prompt-caching-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prompt-caching-patterns
-description: "Loaded when user builds with Anthropic API and needs to cut cost or latency via prompt caching. Covers TTL, cache breakpoints, stacking, invalidation, and measuring hit rate."
+description: "Anthropic API prompt caching: TTL, breakpoints, stacking, invalidation, hit rate. Triggers: prompt caching, cache_control, cache breakpoint, cache TTL, hit rate."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/python-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: python-rules
-description: "Python coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .py, .pyi, pyproject.toml, requirements.txt, Pipfile, FastAPI, Django, Flask, pytest, SQLAlchemy, ruff, mypy. Load when writing, reviewing, or editing Python code."
+description: "Python coding rules: style, patterns, security, testing. Triggers: .py, .pyi, pyproject.toml, requirements.txt, Pipfile, FastAPI, Django, Flask, pytest, SQLAlchemy, ruff, mypy."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/qa-session/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qa-session
-description: "Interactive QA session where user reports bugs conversationally and agent files GitHub issues with domain language. Explores codebase in background for context. Use when user wants to report bugs, do QA, file issues conversationally, or mentions QA session."
+description: "Interactive QA: user reports bugs conversationally, agent files GitHub issues. Triggers: QA session, report bug, file issue, conversational QA, bug intake."
 user-invocable: true
 effort: high
 argument-hint: "[area to QA or first bug report]"

package/app/skills/rag-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rag-patterns
-description: "RAG architecture: embeddings, chunking strategies, hybrid search (BM25 + vector), reranking, CRAG/self-correcting, multi-hop reasoning, evaluation metrics. Triggers: RAG, embedding, vector search, pgvector, Qdrant, Pinecone, Weaviate, chunking, reranker, retrieval, hybrid search, semantic search, knowledge base, cosine similarity. Load when building or tuning RAG systems."
+description: "RAG: embeddings, chunking, hybrid search (BM25+vector), reranking, CRAG, multi-hop. Triggers: RAG, embedding, pgvector, Qdrant, Pinecone, Weaviate, reranker, semantic search."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/refactor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: refactor
-description: "Refactor code for quality and maintainability"
+description: "Refactors code for quality and maintainability. Triggers: refactor, clean up, restructure, improve code, modernize."
 user-invocable: true
 effort: high
 argument-hint: "[target and goal]"

package/app/skills/refactor-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: refactor-plan
-description: "Create a detailed refactor plan with tiny commits via user interview, then file as a GitHub issue RFC. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps."
+description: "Creates detailed refactor plan with tiny commits via interview, files as GitHub RFC. Triggers: refactor plan, refactoring RFC, incremental refactor, safe steps."
 user-invocable: true
 effort: high
 argument-hint: "[area or module to refactor]"

package/app/skills/repeat/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: repeat
-description: "Run a prompt or slash command on a recurring interval until task complete or limits reached. Use when user wants to set up a recurring task, poll for status, or run something repeatedly on an interval."
+description: "Runs prompt/slash command on recurring interval until done or limit. Triggers: repeat, recurring task, poll status, run every N minutes, interval."
 user-invocable: true
 effort: medium
 argument-hint: "[interval] [command or prompt] (e.g., /repeat 5m /test, defaults to 10m)"

package/app/skills/research-mastery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: research-mastery
-description: "Hierarchical information retrieval following strict order: KB first (smart_query/crag_search), then MCP/Context7, then web search, then LLM knowledge as last resort. Triggers: research, find information, verify fact, synthesize sources, fact-check, cross-reference, multi-source, cite sources, investigate topic. Load when any task requires external or cross-source knowledge."
+description: "Hierarchical retrieval: KB first (smart_query/crag_search), then MCP/Context7, then web. Triggers: research, fact-check, verify, synthesize, cross-reference, multi-source, investigate, cite sources."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: review
-description: "Review code for quality, security, and correctness"
+description: "Reviews code for quality, security, correctness. Triggers: code review, quality review, security review, review PR, review branch."
 user-invocable: true
 effort: high
 argument-hint: "[target: branch, pr, file path, or staged changes]"

package/app/skills/rollback/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rollback
-description: "Roll back a git commit, database migration, or deployment to a previous known-good state with safety checks and health verification. Use when the user wants to revert recent changes safely — not to undo local edits or halt the whole system."
+description: "Rolls back git commit, DB migration, or deploy to known-good with safety + health checks. Triggers: rollback, revert deploy, revert migration, rollback commit, git revert."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[target: git/db/deploy]"

package/app/skills/ruby-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ruby-patterns
-description: "Ruby and Rails development patterns: blocks, metaprogramming, ActiveRecord, Sidekiq, RSpec, Sorbet/RBS, Hanami, Roda, Rack middleware. Triggers: Ruby, Rails, ActiveRecord, Sidekiq, RSpec, gem, Gemfile, bundler, rake, Hanami, Sorbet. Load when writing or reviewing Ruby code."
+description: "Ruby/Rails: blocks, metaprogramming, ActiveRecord, Sidekiq, RSpec, Sorbet, Hanami. Triggers: Ruby, Rails, ActiveRecord, Sidekiq, RSpec, Gemfile, bundler, Hanami, Sorbet."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/ruby-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ruby-rules
-description: "Ruby coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .rb, Gemfile, .gemspec, Rails, ActiveRecord, Sidekiq, RSpec, Sorbet, rubocop. Load when writing, reviewing, or editing Ruby code."
+description: "Ruby coding rules: style, patterns, security, testing. Triggers: .rb, Gemfile, .gemspec, Rails, ActiveRecord, Sidekiq, RSpec, Sorbet, rubocop."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/rust-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rust-patterns
-description: "Rust development patterns: ownership, borrowing, lifetimes, async (Tokio), error handling (Result/anyhow/thiserror), traits, macros, zero-cost abstractions, unsafe boundaries. Triggers: Rust, borrow checker, lifetime, Tokio, async Rust, cargo, trait, impl, Result, unsafe, lifetime annotation, clippy. Load when writing or reviewing Rust code."
+description: "Rust: ownership, lifetimes, async (Tokio), Result/anyhow/thiserror, traits, unsafe. Triggers: Rust, borrow checker, lifetime, Tokio, cargo, trait, impl, Result, unsafe, clippy."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/rust-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rust-rules
-description: "Rust coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .rs, Cargo.toml, Cargo.lock, Tokio, Axum, Serde, clippy, cargo test. Load when writing, reviewing, or editing Rust code."
+description: "Rust coding rules: style, patterns, security, testing. Triggers: .rs, Cargo.toml, Cargo.lock, Tokio, Axum, Serde, clippy, cargo test."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/search/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: search
-description: "Search the knowledge base with semantic and hybrid modes"
+description: "Searches the KB with semantic + hybrid modes. Triggers: search KB, semantic search, hybrid search, knowledge base query."
 user-invocable: true
 effort: medium
 argument-hint: "[query]"

package/app/skills/security-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: security-patterns
-description: "Application security: OWASP Top 10, authN/authZ, input validation, secrets management, TLS, CSRF/XSS/SQLi, session handling, JWT, rate limiting, CSP. Triggers: security, OWASP, auth, JWT, CSRF, XSS, SQL injection, secrets, encryption, TLS, authentication, authorization, CSP, CORS, password hashing. Load when touching auth code, handling user input, or doing security review."
+description: "App security: OWASP, authN/authZ, input validation, secrets, TLS, CSRF/XSS/SQLi, JWT, CSP. Triggers: security, OWASP, auth, JWT, CSRF, XSS, SQL injection, secrets, TLS, CSP, CORS."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/seo-validate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: seo-validate
-description: "Validate code against SEO best practices: W3C semantics, meta/OG tags, Schema.org, hreflang, Core Web Vitals (LCP/INP/CLS), resource hints, GEO, SPA/SSG/CSR crawlability, technical SEO, accessibility-for-SEO. Supports React/Next/Nuxt/Astro/Gatsby/SvelteKit/Remix/Angular/Vue/static HTML."
+description: "SEO validator: meta/OG, Schema.org, hreflang, Core Web Vitals, crawlability. Triggers: SEO, meta tags, Schema.org, hreflang, LCP, INP, CLS, Core Web Vitals, sitemap, crawlability."
 user-invocable: true
 effort: medium
 disable-model-invocation: true

package/app/skills/skill-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-audit
-description: "Scan skills and agents for security risks: dangerous patterns, secrets, excessive permissions"
+description: "Scans skills/agents for security risks: dangerous patterns, secrets, excessive perms. Triggers: skill audit, security scan, agent audit, dangerous pattern."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[skill-name | --all | --fix]"

package/app/skills/skill-creator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-creator
-description: "Create new skills from templates with guided workflow"
+description: "Creates new skills from templates via guided workflow. Triggers: new skill, create skill, skill scaffold, skill template."
 effort: high
 disable-model-invocation: true
 argument-hint: "[skill name or description]"

package/app/skills/subagent-development/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: subagent-development
-description: "Execute implementation plans using fresh subagents per task with two-stage review: spec compliance first, then code quality. Use when executing plans with independent tasks."
+description: "Executes plans via fresh subagents per task with two-stage review (spec → quality). Triggers: subagent execution, execute plan, fresh agent per task, spec compliance review."
 user-invocable: true
 effort: high
 argument-hint: "[plan file or task description]"

package/app/skills/swarm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: swarm
-description: "Execute tasks via Map-Reduce, Consensus, or Relay swarms"
+description: "Runs tasks via Map-Reduce, Consensus, or Relay swarms. Triggers: swarm, map-reduce, consensus swarm, relay swarm, parallel agents."
 user-invocable: true
 effort: max
 argument-hint: "[map-reduce|consensus|relay] [--with-kb] [--worktree] [task]"

package/app/skills/swift-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: swift-patterns
-description: "Swift and iOS development patterns: SwiftUI, Combine, async/await, property wrappers, actors, Swift Package Manager, Core Data, UIKit interop, @MainActor. Triggers: Swift, SwiftUI, Combine, iOS, Xcode, actor, property wrapper, Core Data, SPM, UIKit, @MainActor, @State, @Binding. Load when writing or reviewing Swift code."
+description: "Swift/iOS: SwiftUI, Combine, async/await, actors, SPM, Core Data, UIKit interop. Triggers: Swift, SwiftUI, Combine, iOS, Xcode, actor, Core Data, @MainActor, @State."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/swift-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: swift-rules
-description: "Swift coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .swift, Package.swift, .xcodeproj, SwiftUI, Combine, async/await, XCTest. Load when writing, reviewing, or editing Swift code."
+description: "Swift coding rules: style, patterns, security, testing. Triggers: .swift, Package.swift, .xcodeproj, SwiftUI, Combine, async/await, XCTest."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/tdd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tdd
-description: "Test-driven development with red-green-refactor loop and vertical slices. Use when user wants TDD, test-first development, red-green-refactor, or building features with tests driving the implementation."
+description: "TDD with red-green-refactor loop and vertical slices. Triggers: TDD, test-first, red-green-refactor, test driving development."
 user-invocable: true
 effort: high
 argument-hint: "[feature or behavior to implement]"

package/app/skills/teams/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: teams
-description: "Launches pre-configured multi-agent teams for code review, debugging, feature development, security audits, and database migrations. Use when the user asks to start a multi-agent workflow, coordinate agent teams, run a team review, or needs parallel agent collaboration on a complex task."
+description: "Launches multi-agent teams for review, debugging, feature dev, security audits, migrations. Triggers: multi-agent workflow, agent teams, team review, parallel agent collaboration."
 effort: max
 user-invocable: true
 argument-hint: "<preset> [task-description]"

package/app/skills/test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: test
-description: "Run the project's test suite with coverage reporting, auto-detecting the framework (pytest, vitest, jest, flutter test, go test, cargo test, phpunit). Use when the user asks to run existing tests — not to author new ones test-first."
+description: "Runs project test suite with coverage, auto-detects framework (pytest, vitest, jest, flutter, go, cargo, phpunit). Triggers: run tests, test suite, coverage report."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[file or pattern]"

package/app/skills/testing-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: testing-patterns
-description: "Testing strategy and craft: pyramid vs trophy, unit/integration/e2e split, fixtures, mocks vs fakes vs stubs, AAA pattern, flaky test diagnosis, coverage goals, property-based testing. Triggers: test, testing strategy, fixture, mock, stub, AAA, unit test, integration test, e2e, Playwright, Cypress, flaky, coverage, TDD, test pyramid. Load when writing, reviewing, or designing test suites."
+description: "Testing strategy: pyramid, AAA, mocks/fakes/stubs, flaky tests, coverage. Triggers: test, fixture, mock, stub, e2e, TDD, Playwright, Cypress, flaky, coverage, property-based."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/triage-issue/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: triage-issue
-description: "Triage a bug by deeply exploring the codebase for root cause, then create a GitHub issue with a TDD-based fix plan. Mostly hands-off — minimal user interaction. Use when user reports a bug, wants to investigate an issue, mentions triage, or wants a fix plan."
+description: "Bug triage: explores codebase for root cause, files GitHub issue with TDD fix plan. Triggers: triage, investigate bug, fix plan, root cause, file issue, bug report."
 user-invocable: true
 effort: high
 argument-hint: "[bug description or symptom]"

package/app/skills/typescript-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: typescript-patterns
-description: "TypeScript type safety patterns: strict mode, generics, conditional types, template literals, discriminated unions, branded types, Zod, satisfies operator, const assertions. Triggers: TypeScript, TS, generics, conditional type, utility type, strict, Zod, satisfies, discriminated union, type safety, type narrowing, template literal type. Load when writing or reviewing TypeScript code."
+description: "TypeScript type safety: generics, conditional types, discriminated unions, Zod, satisfies, branded types. Triggers: TypeScript, TS, generics, Zod, satisfies, type narrowing, strict mode."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/typescript-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: typescript-rules
-description: "TypeScript/JavaScript coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .ts, .tsx, .js, .jsx, package.json, tsconfig.json, React, Next.js, Vue, Vite, Vitest, Jest, ESLint. Load when writing, reviewing, or editing TypeScript/JavaScript code."
+description: "TypeScript/JavaScript coding rules: style, patterns, security, testing. Triggers: .ts, .tsx, .js, .jsx, package.json, tsconfig.json, React, Next.js, Vue, Vite, Vitest, Jest, ESLint."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/ubiquitous-language/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ubiquitous-language
-description: "Extract a DDD-style ubiquitous language glossary from the conversation, flagging ambiguities and proposing canonical terms. Saves to UBIQUITOUS_LANGUAGE.md. Use when user wants to define domain terms, build a glossary, harden terminology, or mentions DDD or domain model."
+description: "Extracts DDD ubiquitous language glossary, flags ambiguities, saves to UBIQUITOUS_LANGUAGE.md. Triggers: define domain terms, build glossary, harden terminology, DDD, domain model."
 user-invocable: true
 effort: medium
 argument-hint: "[domain or context to extract terms from]"

package/app/skills/verification-before-completion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: verification-before-completion
-description: "Loaded when agent is about to claim work is complete, fixed, or passing — requires running verification commands and confirming output before making any success claims. Evidence before assertions, always."
+description: "Forces verification commands before success claims. Evidence before assertions. Triggers: complete, fixed, passing, done, ready, verified."
 user-invocable: false
 allowed-tools: Read
 ---

package/app/skills/workflow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow
-description: "Start and manage autonomous agent workflows"
+description: "Starts and manages autonomous agent workflows. Triggers: workflow, start workflow, autonomous agents, agent pipeline."
 user-invocable: true
 effort: max
 argument-hint: "[type] [task description]"

package/app/skills/write-a-prd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: write-a-prd
-description: "Create a Product Requirements Document through interactive interview, codebase exploration, and deep module design. Use when user wants to write a PRD, create product requirements, or plan a new feature from scratch."
+description: "Creates PRD via interactive interview + codebase exploration + module design. Triggers: write PRD, product requirements, plan new feature, PRD interview."
 user-invocable: true
 effort: high
 argument-hint: "[feature or problem description]"