add Plano agent skills framework and rule set

[Spherrrical]

Summary

• add a complete skills/ package for Plano with TypeScript tooling to validate rules, compile AGENTS.md, and extract test cases
• add 25 consumer-facing skills rules across configuration, routing, orchestration, guardrails, observability, CLI operations, deployment, and advanced patterns
• include generated artifacts (skills/AGENTS.md, skills/test-cases.json) and project metadata/docs for installation and contribution

Test plan

• Run npm run dev in skills/
• Confirm rule validation passes with zero errors
• Confirm build regenerates skills/AGENTS.md
• Confirm extract step regenerates skills/test-cases.json

[Spherrrical]

#776

[adilhafeez]

I tried to follow through the README.md on how I can test and run these skills. But there aren't clear instructions. Can you please update readme to incluce instructions to run any of these skills?

[Spherrrical]

I tried to follow through the README.md on how I can test and run these skills. But there aren't clear instructions. Can you please update readme to incluce instructions to run any of these skills?

Use npx skills add ./skills --list inside the root directory to test skills. you can invoke directly with natural language and it will guide you on installing them to Claude Code, Cursor, etc.

[adilhafeez]

It looks like skils for claude are not getting installed in correct folder. When I run npx skills add ./skills it installs skills in .agents/skills/ whereas claude looks for .claude/skills/.

This is what I see with default installation,

➜  plano-pr-797 git:(musa/skills) ✗ claude                 
 ...
❯ what skills are here?                                                                              
                       
⏺ Based on the system context, here are the available skills:                                        
                                                                                                   
  Build & Test:                                                                                      
  - build-cli — Build and install the Python CLI (planoai)
  - build-brightstaff — Build the brightstaff native binary                                          
  - build-wasm — Build the WASM plugins for Envoy                                                  
  - check — Run Rust fmt, clippy, and unit tests                                                     
  - test-python — Run Python CLI tests                                                             
                                                                                                     
  Code Quality:                                                                                      
  - simplify — Review changed code for reuse, quality, and efficiency                                
                                                                                                     
  Utilities:                                                                                      
  - loop — Run a prompt or slash command on a recurring interval                                     
  - keybindings-help — Customize keyboard shortcuts                                                  
  - claude-api — Help building apps with the Claude API/Anthropic SDK
                                                                                                     
  There also appears to be a plano-agent-skills directory in the working tree — want me to look into 
  what's there?                                                                                      
                                                                                                     
─────────────────────────────────────────────────────────────────────────────────────────────────────
❯                                                                                                 

and after fixing path,

❯ what skills are here?                                                                              
                       
⏺ Based on the git status and available skill triggers, here are the skills in this repo:            
                                                                                                   
  Core Build/Test Skills:                                                                            
  - build-cli — Build and install the Python CLI (planoai)
  - build-brightstaff — Build the brightstaff native binary                                          
  - build-wasm — Build the WASM plugins for Envoy                                                 
  - check — Run Rust fmt, clippy, and unit tests                                                     
  - test-python — Run Python CLI tests                                                            
                                                                                                     
  Plano Domain Skills (new/untracked):                                                               
  - plano-config-fundamentals — Config versioning, listener types, provider registration, secrets,   
  validation                                                                                         
  - plano-routing-model-selection — Provider defaults, model aliases, passthrough auth, routing      
  preferences                                                                                        
  - plano-filter-guardrails — MCP filter setup, prompt guard responses, filter ordering              
  - plano-agent-orchestration — Agent registration, listener wiring, capability-focused descriptions
  - plano-agent-skills — (moved from skills/ to .claude/skills/)                                     
  - plano-advanced-patterns — Multi-listener systems, prompt target schema, layered orchestration    
  - plano-cli-operations — Startup troubleshooting, cli_agent workflows, prompt target generation    
  - plano-deployment-security — Docker networking, state storage, readiness checks, secrets          
  - plano-observability-debugging — Tracing, sampling strategy, span attributes, root-cause analysis 
                                                                                                     
  Utility Skills:                                                                                    
  - simplify — Review changed code for reuse, quality, efficiency                                    
  - loop — Run a prompt/command on a recurring interval                                              
  - claude-api — Build apps with the Claude API/Anthropic SDK                                     
  - keybindings-help — Customize keyboard shortcuts                                                  
                                                                                                     
  The new Plano domain skills (the plano-* ones) are currently untracked and appear to be part of    
  this branch's changes.                                                                             
                                                                                                     
─────────────────────────────────────────────────────────────────────────────────────────────────────
❯                                                                                                 

[Spherrrical]

@adilhafeez The reason you are seeing a mismatch is because in the CLI selection, you will have to select Claude Code as one of your preferred location of install. By default, .agents/skills is always included as shown in the screenshot. You can see that the other coding agent providers have their own paths of installation. This is something we can't control and up to the Skills CLI to decide where the files end up going - per user selection.