personamanagmentlayer · popey · Mar 12, 2026
diff --git a/docs/examples/skills/python-expert/SKILL.md b/docs/examples/skills/python-expert/SKILL.md
@@ -1,10 +1,7 @@
 ---
 name: python-expert
 description: Expert-level Python programming with PEP 8 standards and modern best practices. Use when writing Python code, debugging Python issues, explaining Python concepts, or reviewing Python code.
-allowed-tools:
-  - Read
-  - Write
-  - Bash(python:*)
+allowed-tools: Read, Write, Bash(python:*)
 ---
 
 # Python Expert

diff --git a/stdlib/ai/ai-architect-expert/SKILL.md b/stdlib/ai/ai-architect-expert/SKILL.md
@@ -1,13 +1,16 @@
 ---
 name: ai-architect-expert
-version: 1.0.0
-description: Expert-level AI system design, MLOps, architecture patterns, and AI infrastructure
-category: ai
-tags: [ai-architecture, mlops, system-design, ai-infrastructure, scalability]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
+description: Expert-level AI system design, MLOps, architecture patterns, and AI infrastructure. Use when working with ai architect, asking about ai architect concepts, or reviewing ai architect code and configurations
+allowed-tools: Read, Write, Edit
+metadata:
+  version: 1.0.0
+  category: ai
+  tags:
+  - ai-architecture
+  - mlops
+  - system-design
+  - ai-infrastructure
+  - scalability
 ---
 
 # AI Architect Expert

diff --git a/stdlib/ai/ai-engineer-expert/SKILL.md b/stdlib/ai/ai-engineer-expert/SKILL.md
@@ -1,14 +1,16 @@
 ---
 name: ai-engineer-expert
-version: 1.0.0
-description: Expert-level AI implementation, deployment, LLM integration, and production AI systems
-category: ai
-tags: [ai-engineering, llm, deployment, production-ai, integration]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(python:*)
+description: Expert-level AI implementation, deployment, LLM integration, and production AI systems. Use when working with ai engineer, asking about ai engineer concepts, or reviewing ai engineer code and configurations
+allowed-tools: Read, Write, Edit, Bash(python:*)
+metadata:
+  version: 1.0.0
+  category: ai
+  tags:
+  - ai-engineering
+  - llm
+  - deployment
+  - production-ai
+  - integration
 ---
 
 # AI Engineer Expert

diff --git a/stdlib/ai/data-science-expert/SKILL.md b/stdlib/ai/data-science-expert/SKILL.md
@@ -1,14 +1,17 @@
 ---
 name: data-science-expert
-version: 1.0.0
-description: Expert-level data science, analytics, visualization, and statistical modeling
-category: ai
-tags: [data-science, analytics, visualization, statistics, pandas, numpy]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(python:*)
+description: Expert-level data science, analytics, visualization, and statistical modeling. Use when working with data science, asking about data science concepts, or reviewing data science code and configurations
+allowed-tools: Read, Write, Edit, Bash(python:*)
+metadata:
+  version: 1.0.0
+  category: ai
+  tags:
+  - data-science
+  - analytics
+  - visualization
+  - statistics
+  - pandas
+  - numpy
 ---
 
 # Data Science Expert

diff --git a/stdlib/ai/ml-expert/SKILL.md b/stdlib/ai/ml-expert/SKILL.md
@@ -1,14 +1,16 @@
 ---
 name: ml-expert
-version: 1.0.0
-description: Expert-level machine learning, deep learning, model training, and MLOps
-category: ai
-tags: [machine-learning, deep-learning, neural-networks, mlops, data-science]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(python:*)
+description: Expert-level machine learning, deep learning, model training, and MLOps. Use when working with ml, asking about ml concepts, or reviewing ml code and configurations
+allowed-tools: Read, Write, Edit, Bash(python:*)
+metadata:
+  version: 1.0.0
+  category: ai
+  tags:
+  - machine-learning
+  - deep-learning
+  - neural-networks
+  - mlops
+  - data-science
 ---
 
 # Machine Learning Expert

diff --git a/stdlib/api/api-design-expert/SKILL.md b/stdlib/api/api-design-expert/SKILL.md
@@ -1,13 +1,16 @@
 ---
 name: api-design-expert
-version: 1.0.0
-description: Expert-level API design principles, REST, GraphQL, versioning, and API best practices
-category: api
-tags: [api-design, rest, graphql, api-versioning, api-security]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
+description: Expert-level API design principles, REST, GraphQL, versioning, and API best practices. Use when working with api design, asking about api design concepts, or reviewing api design code and configurations
+allowed-tools: Read, Write, Edit
+metadata:
+  version: 1.0.0
+  category: api
+  tags:
+  - api-design
+  - rest
+  - graphql
+  - api-versioning
+  - api-security
 ---
 
 # API Design Expert

diff --git a/stdlib/api/fastapi-expert/SKILL.md b/stdlib/api/fastapi-expert/SKILL.md
@@ -1,14 +1,18 @@
 ---
 name: fastapi-expert
-version: 1.0.0
-description: Expert-level FastAPI development for high-performance Python APIs with async support
-category: api
-tags: [fastapi, python, api, async, rest, openapi, pydantic]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(python:*, pip:*, uvicorn:*)
+description: Expert-level FastAPI development for high-performance Python APIs with async support. Use when working with fastapi, asking about fastapi concepts, or reviewing fastapi code and configurations
+allowed-tools: Read, Write, Edit, Bash(python:*, pip:*, uvicorn:*)
+metadata:
+  version: 1.0.0
+  category: api
+  tags:
+  - fastapi
+  - python
+  - api
+  - async
+  - rest
+  - openapi
+  - pydantic
 ---
 
 # FastAPI Expert

diff --git a/stdlib/api/graphql-expert/SKILL.md b/stdlib/api/graphql-expert/SKILL.md
@@ -1,14 +1,18 @@
 ---
 name: graphql-expert
-version: 1.0.0
-description: Expert-level GraphQL API development with schema design, resolvers, and subscriptions
-category: api
-tags: [graphql, api, apollo, schema, resolvers, subscriptions, relay]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(node:*, npm:*, npx:*)
+description: Expert-level GraphQL API development with schema design, resolvers, and subscriptions. Use when working with graphql, asking about graphql concepts, or reviewing graphql code and configurations
+allowed-tools: Read, Write, Edit, Bash(node:*, npm:*, npx:*)
+metadata:
+  version: 1.0.0
+  category: api
+  tags:
+  - graphql
+  - api
+  - apollo
+  - schema
+  - resolvers
+  - subscriptions
+  - relay
 ---
 
 # GraphQL Expert

diff --git a/stdlib/api/grpc-expert/SKILL.md b/stdlib/api/grpc-expert/SKILL.md
@@ -1,13 +1,16 @@
 ---
 name: grpc-expert
-version: 1.0.0
-description: Expert-level gRPC, Protocol Buffers, microservices communication, and streaming
-category: api
-tags: [grpc, protobuf, microservices, rpc, streaming]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
+description: Expert-level gRPC, Protocol Buffers, microservices communication, and streaming. Use when working with grpc, asking about grpc concepts, or reviewing grpc code and configurations
+allowed-tools: Read, Write, Edit
+metadata:
+  version: 1.0.0
+  category: api
+  tags:
+  - grpc
+  - protobuf
+  - microservices
+  - rpc
+  - streaming
 ---
 
 # gRPC Expert

diff --git a/stdlib/api/microservices-expert/SKILL.md b/stdlib/api/microservices-expert/SKILL.md
@@ -1,13 +1,15 @@
 ---
 name: microservices-expert
-version: 1.0.0
-description: Expert-level microservices architecture, patterns, service mesh, and distributed systems
-category: api
-tags: [microservices, distributed-systems, service-mesh, architecture]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
+description: Expert-level microservices architecture, patterns, service mesh, and distributed systems. Use when working with microservices, asking about microservices concepts, or reviewing microservices code and configurations
+allowed-tools: Read, Write, Edit
+metadata:
+  version: 1.0.0
+  category: api
+  tags:
+  - microservices
+  - distributed-systems
+  - service-mesh
+  - architecture
 ---
 
 # Microservices Expert

diff --git a/stdlib/api/openapi-expert/SKILL.md b/stdlib/api/openapi-expert/SKILL.md
@@ -1,14 +1,17 @@
 ---
 name: openapi-expert
-version: 1.0.0
-description: Expert-level OpenAPI/Swagger specification for API design, documentation, and code generation
-category: api
-tags: [openapi, swagger, api-spec, rest, api-design, documentation]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(openapi:*, swagger:*)
+description: Expert-level OpenAPI/Swagger specification for API design, documentation, and code generation. Use when working with openapi, asking about openapi concepts, or reviewing openapi code and configurations
+allowed-tools: Read, Write, Edit, Bash(openapi:*, swagger:*)
+metadata:
+  version: 1.0.0
+  category: api
+  tags:
+  - openapi
+  - swagger
+  - api-spec
+  - rest
+  - api-design
+  - documentation
 ---
 
 # OpenAPI Expert

diff --git a/stdlib/cloud/aws-expert/SKILL.md b/stdlib/cloud/aws-expert/SKILL.md
@@ -1,25 +1,20 @@
 ---
 name: aws-expert
-version: 1.0.0
-description: Expert-level AWS cloud architecture, services, security, cost optimization, and best practices
-category: cloud
-author: PCL Team
+description: Expert-level AWS cloud architecture, services, security, cost optimization, and best practices. Use when working with aws, asking about aws concepts, or reviewing aws code and configurations
+allowed-tools: Read, Write, Edit, Bash(aws:*), Glob, Grep
 license: Apache-2.0
-tags:
+metadata:
+  version: 1.0.0
+  category: cloud
+  author: PCL Team
+  tags:
   - aws
   - cloud
   - infrastructure
   - devops
   - serverless
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(aws:*)
-  - Glob
-  - Grep
-requirements:
-  aws-cli: ">=2.0"
+  requirements:
+    aws-cli: '>=2.0'
 ---
 
 # AWS Expert

diff --git a/stdlib/cloud/azure-expert/SKILL.md b/stdlib/cloud/azure-expert/SKILL.md
@@ -1,14 +1,16 @@
 ---
 name: azure-expert
-version: 1.0.0
-description: Expert-level Microsoft Azure cloud platform, services, and architecture
-category: cloud
-tags: [azure, cloud, microsoft, azure-functions, cosmos-db]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(az:*)
+description: Expert-level Microsoft Azure cloud platform, services, and architecture. Use when working with azure, asking about azure concepts, or reviewing azure code and configurations
+allowed-tools: Read, Write, Edit, Bash(az:*)
+metadata:
+  version: 1.0.0
+  category: cloud
+  tags:
+  - azure
+  - cloud
+  - microsoft
+  - azure-functions
+  - cosmos-db
 ---
 
 # Microsoft Azure Expert

diff --git a/stdlib/cloud/cloudflare-expert/SKILL.md b/stdlib/cloud/cloudflare-expert/SKILL.md
@@ -1,14 +1,16 @@
 ---
 name: cloudflare-expert
-version: 1.0.0
-description: Expert-level Cloudflare Workers, CDN, edge computing, and security services
-category: cloud
-tags: [cloudflare, edge-computing, cdn, workers, waf]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(wrangler:*)
+description: Expert-level Cloudflare Workers, CDN, edge computing, and security services. Use when working with cloudflare, asking about cloudflare concepts, or reviewing cloudflare code and configurations
+allowed-tools: Read, Write, Edit, Bash(wrangler:*)
+metadata:
+  version: 1.0.0
+  category: cloud
+  tags:
+  - cloudflare
+  - edge-computing
+  - cdn
+  - workers
+  - waf
 ---
 
 # Cloudflare Expert

diff --git a/stdlib/cloud/gcp-expert/SKILL.md b/stdlib/cloud/gcp-expert/SKILL.md
@@ -1,14 +1,16 @@
 ---
 name: gcp-expert
-version: 1.0.0
-description: Expert-level Google Cloud Platform, services, and cloud architecture
-category: cloud
-tags: [gcp, google-cloud, cloud-functions, bigquery, firestore]
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash(gcloud:*)
+description: Expert-level Google Cloud Platform, services, and cloud architecture. Use when working with gcp, asking about gcp concepts, or reviewing gcp code and configurations
+allowed-tools: Read, Write, Edit, Bash(gcloud:*)
+metadata:
+  version: 1.0.0
+  category: cloud
+  tags:
+  - gcp
+  - google-cloud
+  - cloud-functions
+  - bigquery
+  - firestore
 ---
 
 # Google Cloud Platform Expert