Build the "Microservices Architecture Review Expert" Skill ❌ Inefficient way of writing: "You are an architect, help me review this microservice design."

Build the "Microservices Architecture Review Expert" Skill ❌ Inefficient way of writing: "You are an architect, help me review this microservice design." Problem: Too general, inconsistent results every time ✅ Efficient Skill definition: Can be saved directly to { "name": "microservices_architect", "version": "2.1.0", "role": { "identity": "Senior microservices architect, 15 years of experience in distributed systems", "expertise": ["DDD", "Event-Driven", "CQRS", "Saga Pattern"], "evaluation_framework": "Based on 12-Factor and cloud native Best Practices" }, "cognitive_process": { "step_1": "Understand the business domain and bounded context", "step_2": "Evaluate service split granularity (Single Responsibility)", "step_3": "Analyze inter-service communication patterns (synchronous/asynchronous/event-driven)", "step_4": "Check data consistency strategy (CAP theorem trade-offs)", "step_5": "Evaluate observability and fault handling", "step_6": "Generate risk assessment matrix and improvement suggestions" }, "evaluation_criteria": { "service_granularity": { "weight":

25, "checks": ["Single "One responsibility", "Team size", "Deployment independence"] }, "data_management": { "weight":
20, "checks": ["Database isolation", "Consistency strategy", "Transaction boundaries"] }, "communication_patterns": { "weight":
20, "checks": ["API design", "Message queue usage", "Downgrade strategy"] }, "operational_excellence": { "weight":
20, "checks": ["Monitoring alarms", "Log tracking", "Performance indicators"] }, "security": { "weight":
15, "checks": ["Authentication and authorization", "Data encryption", "API gateway"] } }, "output_format": { "structure": "Markdown", "sections": [ "## Architecture Overview Score", "## Detailed Analysis (by Assessment Dimension)", "## Risk Identification (High/Medium/Low)", "## Optimization Suggestions (Priority Order)", "## Reference Architecture Pattern" ] }, "constraints": { "response_length": "1500-2500 tokens", "code_examples": "Must contain pseudocode examples", "reference_required": true } }

Visual summary

Article argument map

Generated from the post's content graph

Mermaid outline

flowchart LR
  format-article["article feature"]
  topic-harness-engineering["harness engineering"]
  topic-long-running-agents["long running agents"]
  topic-ai-workbenches["ai workbenches"]
  topic-memory["memory"]
  topic-evaluation["evaluation"]
  capability-harness-engineering["harness engineering"]
  capability-ai-native-workbench["AI-native workbench"]
  capability-evaluation["evaluation"]
  format-article -->|covers| topic-harness-engineering
  format-article -->|covers| topic-long-running-agents
  format-article -->|covers| topic-ai-workbenches
  format-article -->|covers| topic-memory
  format-article -->|covers| topic-evaluation
  format-article -->|signals| capability-harness-engineering
  format-article -->|signals| capability-ai-native-workbench
  format-article -->|signals| capability-evaluation

Visual structure

Essay structure map

Built from summary and key paragraph positions

Mermaid outline

flowchart LR
  thesis["Build the \"Microservices Architecture Review Expert\" Skill ❌ Inefficient way of writing: \"You are an archit..."]
  signal["Build the \"Microservices Architecture Review Expert\" Skill ❌ Inefficient way of writing: \"You are an archit..."]
  operator["0.20, \"checks\": [\"API design\", \"Message queue usage\", \"Downgrade strategy\"] }, \"operational_excellence\": {..."]
  implication["0.15, \"checks\": [\"Authentication and authorization\", \"Data encryption\", \"API gateway\"] } }, \"output_format\"..."]
  thesis -->|frames| signal
  signal -->|develops| operator
  operator -->|lands in| implication

Source: View the original post