Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions Releases/v4.0.3/.claude/PAI/SKILLSYSTEM.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,66 @@ If a skill does not follow this structure, it is not properly configured and wil

---

## Sub-Skill Frontmatter (MANDATORY)

**Every nested sub-skill `SKILL.md` MUST set `user-invocable: false`
in its YAML frontmatter.**

### Why

Claude Code auto-indexes every `SKILL.md` file in the `skills/` tree
and advertises each one as an invokable slash-command tip. PAI
organizes skills hierarchically — a top-level `SKILL.md` is
user-invokable, but sub-skills nested underneath are routed to by
the parent's Workflow Routing table and are NOT meant to be invoked
by the user directly. Without the `user-invocable: false` flag,
Claude Code advertises broken tips like `/annual-reports` that do
not work when the user tries them, eroding trust in every tip the
system emits.

The `user-invocable: false` frontmatter field is the spec-blessed
mechanism for this. From the Claude Code Skills documentation:

> `user-invocable` — Set to `false` to hide from the `/` menu. Use
> for background knowledge users shouldn't invoke directly.
> Default: `true`.

Reference: https://code.claude.com/docs/en/skills (Frontmatter
reference table).

### Correct frontmatter for a nested sub-skill

```yaml
---
name: AnnualReports
description: [...]. USE WHEN annual reports, security trends, [...].
user-invocable: false
---
```

### Rule

- **Top-level skills** (`skills/<Name>/SKILL.md`): no
`user-invocable` field (defaults to `true`, user-invokable).
- **Nested sub-skills** (`skills/<Parent>/<SubSkill>/SKILL.md` and
deeper): MUST include `user-invocable: false`.

Parent skill routing tables continue to reference sub-skill paths
as before — `user-invocable: false` hides the skill from the `/`
menu but does not prevent Claude from reading the file when
directed by the parent.

### Validator check

```bash
# Every nested SKILL.md must contain `user-invocable: false`
find ~/.claude/skills -mindepth 3 -name SKILL.md \
-exec grep -L '^user-invocable: false$' {} +
# MUST return empty.
```

---

## Personal vs System Skills (CRITICAL)

**Skills are classified into two categories:**
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: ExtractWisdom
description: 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.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: OSINT
description: 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.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: PrivateInvestigator
description: Ethical people-finding using 15 parallel research agents (45 search threads) across public records, social media, reverse lookups. Public data only, no pretexting. USE WHEN find person, locate, reconnect, people search, skip trace, reverse lookup, social media search, public records search, verify identity.
user-invocable: false
---

## Customization
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Media/Art/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Art
description: Generate illustrations, technical diagrams, mermaid flowcharts, infographics, header images, thumbnails, comics, and PAI pack icons using multiple rendering backends. USE WHEN art, header images, visualizations, mermaid, flowchart, technical diagram, infographic, PAI icon, pack icon, YouTube thumbnails, ad hoc thumbnails, annotated screenshots, aphorisms, comics, comparisons, D3 dashboards, embossed logo wallpaper, essay illustration, frameworks, maps, recipe cards, remove background, stats, taxonomies, timelines, brand wallpaper, visualize, generate image, Midjourney, compose thumbnail, generate prompt.
user-invocable: false
---

# Art Skill
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Media/Remotion/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Remotion
description: Programmatic video creation with React via Remotion — compositions, animations, motion graphics, rendered to MP4. USE WHEN video, animation, motion graphics, video rendering, React video, intro video, YouTube video, TikTok video, video production, render video, content to animation, animate content, video overlay.
user-invocable: false
---

## 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Scraping/Apify/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Apify
description: Social media scraping, business data, e-commerce via Apify actors — with auto-update workflow for actor catalog. USE WHEN Twitter, Instagram, LinkedIn, TikTok, YouTube, Facebook, Google Maps, Amazon scraping, Apify, update Apify actors, social media scraping, lead generation, web scraper.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: BrightData
description: 4-tier progressive URL scraping and multi-page crawling — WebFetch, then Chrome-header curl, then Playwright browser, then Bright Data proxy. Auto-escalates when lower tiers fail. USE WHEN Bright Data, scrape URL, web scraping, site blocking me, can't access, bot detection, crawl site, crawl pages, spider, CAPTCHA, four tier scrape, progressive scraping, Chrome headers.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: AnnualReports
description: Aggregate and analyze annual security reports from major vendors — extract trends, compare threat landscapes year-over-year, produce synthesized threat intelligence summaries. Fetch, list, and update report sources. USE WHEN annual reports, security reports, threat reports, industry reports, vendor reports, threat landscape, fetch report, list sources, update sources.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: PromptInjection
description: Test LLM applications for prompt injection vulnerabilities — jailbreak attempts, system prompt extraction, context manipulation, guardrail bypass techniques, direct injection, indirect injection, multi-stage attacks, and reconnaissance. USE WHEN prompt injection, jailbreak, LLM security, AI security assessment, pentest AI application, test chatbot, guardrail bypass, direct injection, indirect injection, RAG poisoning, multi-stage attack, complete assessment, reconnaissance.
user-invocable: false
---

## Customization
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Security/Recon/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Recon
description: Network reconnaissance — subdomain enumeration, port scanning, DNS/WHOIS/ASN lookups, endpoint discovery from JS, mass scanning, path discovery, CIDR/netblock analysis. Passive and active modes with corporate structure mapping and bounty program tracking. USE WHEN recon, reconnaissance, bug bounty, bounty programs, attack surface, subdomains, subdomain enumeration, port scan, mass scan, DNS, WHOIS, ASN, CIDR, netblock, IP recon, domain recon, passive recon, corporate structure, endpoint discovery, path discovery, scan results, analyze scan, update tools.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: SECUpdates
description: Security news from tldrsec, no.security, Krebs, Schneier, and other sources. USE WHEN security news, security updates, what's new in security, breaches, security research, sec updates, tldrsec, Krebs, Schneier.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: WebAssessment
description: Full web app security assessment — app understanding, threat modeling, OWASP testing, ffuf fuzzing, Playwright automation, AI-assisted vuln analysis. Coordinates with Recon and PromptInjection skills. USE WHEN web assessment, pentest, security testing, vulnerability scan, threat model app, understand application, create threat model, vulnerability analysis, Gemini analysis, ffuf, fuzzing, bug bounty, OSINT, browser automation, Playwright.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: BeCreative
description: Divergent ideation via Verbalized Sampling + extended thinking (1.6-2.1x diversity). USE WHEN be creative, deep thinking, brainstorm, divergent ideas, creative solutions, maximum creativity, tree of thoughts, idea generation, domain specific creativity, technical creativity, standard creativity.
user-invocable: false
---

## Customization
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Thinking/Council/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Council
description: Multi-agent debate with visible transcripts where agents respond to each other. USE WHEN council, debate, perspectives, weigh options, deliberate, multiple viewpoints. Unlike RedTeam (adversarial), Council is collaborative-adversarial.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: FirstPrinciples
description: Decompose to axioms, challenge inherited assumptions, reconstruct from verified truths. USE WHEN first principles, fundamental, root cause, decompose, challenge assumptions, rebuild from scratch.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: IterativeDepth
description: 2-8 scientific lens passes to surface hidden requirements single-pass analysis misses. USE WHEN iterative depth, deep exploration, multi-angle analysis, multiple perspectives, examine from angles, surface hidden requirements.
user-invocable: false
---

## Customization
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Thinking/RedTeam/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: RedTeam
description: 32 adversarial agents to destroy weak arguments and find fatal flaws — parallel analysis and adversarial validation. USE WHEN red team, attack idea, counterarguments, critique, stress test, poke holes, devil's advocate, find weaknesses, break this, parallel analysis, adversarial validation.
user-invocable: false
---

## Customization
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Thinking/Science/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Science
description: Hypothesis-test-analyze cycles for systematic problem-solving — the meta-skill governing all others. Includes define goal, generate hypotheses, design experiment, measure results, analyze results, iterate, full cycle, quick diagnosis, and structured investigation. USE WHEN think about, figure out, try approaches, experiment with, iterate on, improve, optimize, define goal, generate hypotheses, design experiment, measure results, analyze results, full cycle, quick diagnosis, structured investigation, science, hypothesis.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: WorldThreatModelHarness
description: Stress-test ideas, strategies, and investments across 11 time horizons (6mo-50yr). Update and view world models. USE WHEN threat model, world model, test idea, test strategy, future analysis, test investment, test against future, stress test idea, time horizon analysis, update models, view models, refresh models, model status.
user-invocable: false
---

# World Threat Model Harness
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Aphorisms
description: CRUD on {PRINCIPAL.NAME}'s curated aphorism collection — search by theme, add with metadata, research thinkers, match quotes to newsletter content. USE WHEN aphorism, quote, saying, find quote for newsletter, research thinker quotes, add aphorism, search aphorisms, find aphorism.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: AudioEditor
description: AI-powered audio/video editing — transcription, intelligent cut detection, automated editing with crossfades, and optional cloud polish. USE WHEN clean audio, edit audio, remove filler words, clean podcast, remove ums, fix audio, cut dead air, polish audio, clean recording, transcribe and edit.
user-invocable: false
---

# AudioEditor
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Utilities/Browser/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
name: Browser
description: Visual verification and browser automation via Playwright. Headless or headed Chrome. USE WHEN browser, screenshot, debug web, verify UI, troubleshoot frontend, automate browser, browse website, review stories, run stories, recipe, web automation.
version: 3.3.0
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Cloudflare
description: Deploy and manage Cloudflare Workers, Pages, and services via Code Mode MCP (API queries) + wrangler (deploys). OAuth auth for wrangler (tokens lack Pages perms). USE WHEN Cloudflare, worker, deploy, Pages, MCP server, wrangler, DNS, KV, R2, D1, Vectorize.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: CreateCLI
description: Generate production-ready TypeScript CLIs with 3-tier template system (simple argv, yargs, oclif), type safety, error handling, and documentation. USE WHEN create CLI, build CLI, command-line tool, wrap API, add command, upgrade tier, TypeScript CLI.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: CreateSkill
description: Scaffold new PAI skills with proper YAML front matter, TitleCase naming, flat folder structure (SKILL.md + Workflows/ + Tools/), and validation against SkillSystem.md. USE WHEN create skill, new skill, skill structure, canonicalize, validate skill, update skill, fix skill structure, scaffold skill.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,36 @@ skills/OSINT/Workflows/CompanyDueDiligence.md

**Rule:** If you need to organize many files, use clear filenames NOT subdirectories.

### Nested Sub-Skill Frontmatter

**Every nested `SKILL.md` (depth ≥ 2) MUST set `user-invocable: false`
in its YAML frontmatter.**

```bash
# Every nested SKILL.md must have the flag
find ~/.claude/skills -mindepth 3 -name SKILL.md \
-exec grep -L '^user-invocable: false$' {} +
# MUST return empty.
```

Why: Claude Code auto-indexes every `SKILL.md` and advertises each
as a `/slash-command` tip. Nested sub-skills are routed to by the
parent, not invoked by the user, so they must be hidden from the `/`
menu via the `user-invocable: false` frontmatter field.

When canonicalizing a nested sub-skill, add the field to its
frontmatter if missing:

```yaml
---
name: SubSkillName
description: [...]
user-invocable: false
---
```

See `PAI/SKILLSYSTEM.md § Sub-Skill Frontmatter` for the full rule.

---

## Step 6: Convert YAML Frontmatter
Expand Down Expand Up @@ -290,6 +320,7 @@ Run checklist:
- [ ] Workflows contain ONLY work execution procedures
- [ ] Reference docs live at skill root (not in Workflows/)
- [ ] No `backups/` directory inside skill
- [ ] Nested sub-skills set `user-invocable: false` in frontmatter

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -150,6 +150,22 @@ Verify:
- No `backups/` directory inside skill
- Reference docs at skill root (not in Workflows/)

### Sub-Skill Frontmatter

**If this is a nested sub-skill** (lives at depth ≥ 2 under
`skills/`, e.g., `skills/<Parent>/<SubSkill>/SKILL.md`), its YAML
frontmatter MUST set `user-invocable: false`:

```bash
grep -q '^user-invocable: false$' ~/.claude/skills/[Parent]/[SubSkill]/SKILL.md
```

Why: Claude Code auto-indexes every `SKILL.md` and advertises each
as a `/slash-command` tip. Sub-skills are routed to by the parent,
not invoked by the user, so they must be hidden from the `/` menu.

See `PAI/SKILLSYSTEM.md § Sub-Skill Frontmatter` for the full rule.

---

## Step 7a: Check CLI-First Integration (for skills with CLI tools)
Expand Down Expand Up @@ -216,6 +232,7 @@ grep -l "Intent-to-Flag" ~/.claude/skills/[SkillName]/Workflows/*.md
### Structure
- [ ] `tools/` directory exists
- [ ] No `backups/` inside skill
- [ ] Nested sub-skills set `user-invocable: false` in frontmatter

### CLI-First Integration (for skills with CLI tools)
- [ ] CLI tools expose configuration via flags (not hardcoded)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Delegation
description: Parallelize work via background/foreground agents, built-in types, custom agents, or agent teams/swarms. USE WHEN 3+ independent workstreams, parallel execution, agent specialization, Extended+ effort, agent team, swarm, create an agent team.
user-invocable: false
---

# Delegation — Agent Orchestration & Parallelization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Docx
description: Create, edit, and analyze Word documents — tracked changes, tables, images, complex formatting, and format conversion. USE WHEN docx, Word document, create document, tracked changes, redlining.
user-invocable: false
---

# DOCX creation, editing, and analysis
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Pdf
description: Create, merge, split, extract text/tables from PDFs, fill forms, add watermarks, and convert to/from other formats. USE WHEN pdf, PDF file, merge PDF, extract tables, fill form, split PDF.
user-invocable: false
---

# PDF Processing Guide
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Pptx
description: Create, edit, and analyze PowerPoint presentations — slide layouts, speaker notes, design elements, and format conversion. USE WHEN pptx, PowerPoint, slides, presentation, create slides, speaker notes.
user-invocable: false
---

# PPTX creation, editing, and analysis
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Documents
description: Read, write, convert, and analyze documents — routes to PDF, DOCX, XLSX, PPTX sub-skills for creation, editing, extraction, and format conversion. USE WHEN document, process file, create document, convert format, extract text, PDF, DOCX, XLSX, PPTX, Word, Excel, spreadsheet, PowerPoint, presentation, slides, consulting report, large PDF, merge PDF, fill form, tracked changes, redlining.
user-invocable: false
---

## Customization
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Xlsx
description: Create, read, analyze Excel workbooks — formulas, financial models, data analysis, recalculation, and CSV/TSV conversion. USE WHEN xlsx, Excel, spreadsheet, formulas, financial model, data analysis.
user-invocable: false
---

# Requirements for Outputs
Expand Down
1 change: 1 addition & 0 deletions Releases/v4.0.3/.claude/skills/Utilities/Evals/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: Evals
description: Objective eval metrics via code/model/human graders with pass@k/pass^k scoring. USE WHEN eval, evaluate, test agent, benchmark, verify behavior, regression test, capability test, run eval, compare models, compare prompts, create judge, create use case, view results, failure to task, suite manager, transcript capture, trial runner.
user-invocable: false
---

## Customization
Expand Down
Loading