pai-skills

Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, managing credentials, auditing instance security, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. IMPORTANT — Always consult this skill before calling any n8n-mcp tool — it prevents common mistakes like wrong nodeType formats, incorrect parameter structures, and inefficient tool usage. If the user mentions n8n, workflows, nodes, or automation and you have n8n MCP tools available, use this skill first.

Expert n8n workflow development — expression syntax, MCP tools, workflow patterns, node configuration, validation, Code node JS/Python, n8nac code-first development, and code-mode runtime optimization. USE WHEN n8n, n8n workflow, build workflow, n8n node, n8n expression, n8n validation, n8n code node, n8n pattern, n8n MCP, automation workflow, n8n template, webhook workflow, batch processing, n8n agent, n8n javascript, n8n python, workflow architecture, n8nac, n8n-as-code, code-first, workflow.ts, n8nac push, n8nac pull, n8nac init, code-mode, sandbox, token savings, tool consolidation, sibling tools, lazy import.

Developer utilities — CLI generation, skill scaffolding, agent delegation, system upgrades, evals, documents, parsing, audio editing, Codex, Cloudflare, browser automation, prompting, aphorisms, n8n workflows, beads management, full output enforcement, knowledge base, compound engineering. USE WHEN create CLI, scaffold skill, delegate, upgrade system, eval, document, parse, cloudflare, browser, n8n, beads, full output, knowledge, compound engineering.

any input (code, docs, papers, images) - knowledge graph - clustered communities - HTML + JSON + audit report

Compose CUSTOM agents from Base Traits + Voice + Specialization for specialized perspectives. USE WHEN create custom agents, spin up agents, specialized agents, agent personalities, available traits, list traits, agent voices, compose agent, load agent context, agent profile, spawn parallel agents, launch agents. NOT for agent teams/swarms (use Delegation skill → TeamCreate) or Codex delegation (use Delegation skill → CodexBridge).

Audit or initialize repo Beads workflow and files. USE WHEN bootstrap Beads, adopt Beads, standardize Beads workflow, initialize a new repo onto Beads, or verify whether a repo already has mature Beads doctrine.

Turn raw failures into high-signal beads. USE WHEN logs, repro commands, or observed behavior need to become self-contained evidence-first tasks instead of vague TODOs.

Build repeatable Beads formulas and workflow packs. USE WHEN recurring operational work should become dependency-aware templates with gates, examples, and dry-run validation.

Audit and repair Claude-side Beads hook behavior on the local machine. USE WHEN Beads hooks, SessionStart, PreCompact, Stop, PostToolUse, hook doctrine, auto-close risk, or machine-level Beads alignment.

Rehearse Beads recovery and drift handling. USE WHEN backup, restore, pull or push, lock cleanup, or mode-transition safety should be audited before trusting Beads operationally.

Research Beads best practices from primary sources. USE WHEN real Beads documentation, senior-user workflow patterns, architecture drift analysis, or source-grounded Beads doctrine and recommendations are needed.

Beads operating system for repo and machine workflow. USE WHEN Beads, beads bootstrap, beads upgrade, beads hooks, beads topology, beads formulas, beads recovery, beads research, or making Beads foolproof across sessions and repos.

Choose the right Beads collaboration topology. USE WHEN deciding between embedded single-clone, shared-remote clones, per-clone remotes, or server mode for concurrent writers.

Audit and safely upgrade a repo's Beads operating tier. USE WHEN evolve Beads workflow, move T1 to T2, move T2 to T3, add multi-agent coordination, add routing or orchestration, or confirm that no upgrade is justified.

Audit a repo's live Beads posture before migration or coordination work. USE WHEN verify backend mode, remotes, hooks, legacy drift, or whether a repo is safe to upgrade, share, or recover.

Multi-language codebase health scanner — technical debt scoring and cleanup plans. USE WHEN desloppify, health scan, technical debt, health score, cleanup plan, debt audit, code health.

Lightweight batch refactoring using jscpd, knip, eslint, ast-grep. USE WHEN refactor, scan for duplication, find dead code, unused exports, cleanup session, refactoring pass.

Structured code review methodology — 5-axis evaluation, severity classification, named simplification patterns. USE WHEN code review, review code, review PR, review changes, review diff, review this, quality review, review before merge, review my code, pull request review, change review, shellcheck, shell lint, bash lint, script analysis.

Content-adaptive wisdom extraction — detects what domains exist in content and builds custom sections (not static IDEAS/QUOTES). Produces tailored insight reports from videos, podcasts, articles. USE WHEN extract wisdom, analyze video, analyze podcast, extract insights, what's interesting, extract from YouTube, what did I miss, key takeaways.

AI builders digest — monitors top AI builders on X and YouTube podcasts, remixes content into digestible summaries. USE WHEN AI builders digest, AI industry insights, builder updates, /ai, follow builders, AI news digest, what are builders saying, AI trends from builders.

Content extraction and analysis — wisdom extraction, summarization, web scraping, transcription, slide extraction, YouTube to ebook, and AI builders digest. USE WHEN extract wisdom, content analysis, summarize URL, extract transcript, YouTube transcript, batch summarize, scrape website, newspaper4k, youtube to ebook, channel digest, AI builders digest, follow builders.

Universal content extraction, summarization, web scraping, and transcription via summarize CLI (v0.11.1). USE WHEN summarize URL, extract transcript, YouTube transcript, summarize video, summarize article, batch summarize, extract slides, transcribe audio, summarize webpage, scrape website, extract markdown, web extraction, content extraction, scrape URL, podcast transcript, audio to text, video slides, OCR slides, extract content from URL.

Transform YouTube videos into beautifully formatted ebook articles with transcripts

CLI-first structured data processing — DuckDB SQL on local files, miller record transforms, xsv CSV operations, gron JSON flattening, jq/yq native patterns. USE WHEN data processing, CSV, JSON, parquet, SQL query, data transform, structured data, DuckDB, miller, xsv, aggregate, filter data, convert format, data analysis, query CSV, join files, column stats, flatten JSON, greppable JSON, format conversion, TSV, record transform, data pipeline.

Structured data processing and economic metrics — DuckDB SQL, miller, xsv, gron, jq/yq for local files plus 68 US economic indicators from FRED, EIA, Treasury, BLS. USE WHEN data processing, CSV, JSON, parquet, SQL query, DuckDB, miller, xsv, aggregate, filter data, data analysis, GDP, inflation, unemployment, economic metrics, FRED, economic overview, US metrics.

68 US economic indicators from FRED, EIA, Treasury, BLS, Census APIs with trend analysis and cross-metric correlation. Updates Substrate dataset, produces economic overviews. USE WHEN GDP, inflation, unemployment, economic metrics, gas prices, how is the economy, update data, refresh data, get current state, economic overview, FRED, fetch FRED series, generate analysis, update substrate metrics, US metrics, economic trends.

Turn any codebase into interactive HTML courses for non-technical people. USE WHEN codebase to course, interactive tutorial, teach code, code walkthrough, learn from codebase, explain codebase interactively.

Documentation practices — comment guidelines, ADR conventions, API documentation, inline docs philosophy, doc health scanning and maintenance. USE WHEN documentation, write docs, comment guidelines, ADR, architecture decision, API docs, JSDoc, OpenAPI, document code, when to comment, how to document, self-documenting code, README, doc health, doc drift, stale docs, fix docs, doc maintenance, check docs.

76 brand design systems as DESIGN.md references — 7 bundled locally (Apple, Claude, Cursor, Figma, Spotify, Stripe, Vercel), 69+ fetchable on demand from getdesign.md. Use as starting point for design inspiration, then customize. USE WHEN brand design, design like stripe, design like apple, design inspiration, brand reference, design system reference, getdesign, design.md, start from brand, copy brand style, look like vercel, build like spotify, design reference.

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

Frontend UI engineering and aesthetic standards — design thinking, anti-AI-slop rules, component architecture, responsive design, accessibility, and design review. Incorporates official Anthropic frontend-design skill aesthetics. USE WHEN building UI, generating HTML, frontend work, design review, component architecture, responsive design, anti-slop, design system, WCAG, accessibility review, build web component, build page, build application.

Deep WCAG 2.2 AA accessibility audit using specialist agents. Use for public-facing pages, portfolio deploys, or when Impeccable/audit flags a11y issues. Slower than /audit but catches everything.

Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition.

Improves typography by fixing font choices, hierarchy, sizing, weight, and readability so text feels intentional. Use when the user mentions fonts, type, readability, text hierarchy, sizing looks off, or wants more polished, intentional typography.

Frontend design and website engineering — standards, anti-slop rules, aesthetic presets, website factory, design intelligence, audit commands, and site teardown. USE WHEN building UI, HTML, frontend, design review, responsive, website factory, portfolio site, landing page, impeccable, audit, typeset, animate, colorize, critique, layout, polish, delight, harden, site teardown, clone website, redesign.

Data-driven UI/UX design intelligence — 67 styles, 161 palettes, 57 font pairings, 25 chart types, 99 UX guidelines across 16 tech stacks. Python search tool for context-aware design recommendations. USE WHEN design system, color palette, font pairing, style selection, UX guidelines, chart design, design review, UI audit, landing page design, dashboard design, SaaS design, glassmorphism, claymorphism, brutalism, neumorphism, bento grid, dark mode, responsive design, product type design, design intelligence, pro max.

Professional website creation workflow — Claude Code + Taste Skill + AI-generated 3D assets (Nano Banana, Seedance, Kling) + Netlify deploy. USE WHEN build website, create website, website factory, portfolio site, landing page, deploy site, taste skill, website with video, animated website, hero video, frontend factory, high-end website, website design.

Pre-deployment verification checklists customized to your stack. USE WHEN deploy checklist, pre-deploy, ready to ship, deploy verification, release checklist, go-no-go, deploy readiness, before deploying, ship it, production deploy, rollback plan, sops, secrets check, encrypted config, pre-deploy secrets.

Git workflow and versioning — atomic commits, save point pattern, worktrees for parallel agents, commit conventions, change summaries. USE WHEN git workflow, commit strategy, branching, git conventions, commit message, worktree, parallel work, save point, git bisect, version control, how to commit, when to commit, split commits, act, local actions, test workflow, git-cliff, changelog, release notes.

Structured OSINT investigations — people lookup, company intel, investment due diligence, entity/threat intel, domain recon, organization research using public sources with ethical authorization framework. USE WHEN OSINT, due diligence, background check, research person, company intel, investigate, company lookup, domain lookup, entity lookup, organization lookup, threat intel, discover OSINT sources.