WEB-002-rest-api-designer

# REST API Designer

 Field | Value |
|-------|-------|
| **Domain** | Web Development |
| **Skill ID** | `WEB-002` |
| **Difficulty** | Intermediate |
| **Exec Time** | 2–5s |
| **Skill Type** | Analytical |
| **Reasoning** | ReAct (Reason + Act) |
| **Output Format** | Markdown |

### [1] Input Intelligence

- **Accepts:** `text, JSON context, workspace files, web documentation URL` *(fill in for your implementation)*
- **Intent:** Detect user intent related to *rest api designer*
- **Entities to Extract:** `Code Logic, Security Dependencies, User Configurations`
- **Validation:** `Validates JSON structure, verifies execution endpoints exist, asserts parameter typing`
- **Ambiguity Handler:** Ask clarifying question if confidence < 70%

### [2] Reasoning Engine

- **Strategy:** ReAct (Reason + Act)
- **Sub-tasks:**
  1. Parse and validate the input for *rest api designer* context
  2. `Construct enterprise DAG strategy matching REST API Designer`
  3. `Evaluate sub-task dependencies using static analysis`
  4. `Render verified components mapping strictly to SkilloAI architecture`
  5. Synthesize results and prepare output
- **Domain Rules:** `- Must eliminate unnecessary abstractions
- Enforce strict typing
- Verify API boundary safety`
- **Fallback:** If reasoning fails → return partial result + ask user
- **Confidence Threshold:** 75% minimum to auto-proceed

### [3] Tool Execution

- **Primary Tool:** `ESLint` — `Executes the primary heavy-lifting specific to the domain logic`
- **Secondary Tool:** `Playwright` — `Provides validation, fallback, or post-processing security checks`
- **Execution Order:** `Parallel (unless specifically blocked)`
- **Error Handling:** Retry × 2 → fallback tool → graceful error message
- **Data Flow:** `ESLint output → AST & Schema normalizer → Playwright input`

### [4] Knowledge & Memory

- **Primary Source:** RAG (LlamaIndex)
- **Context Injected At:** Stage 2 (Reasoning) + Stage 3 (Tool Execution)
- **Write-back:** Store `execution latency, failure rates, context compression metrics` after each run
- **Freshness Policy:** `Real-time execution memory`
- **Personalization:** `User-level context isolation`

### [5] Output Optimization

- **Format:** Markdown
- **Quality Checks:** `Strict Schema JSON validation + Halucination bounds`
- **Tone:** `Technical & Direct`
- **Follow-up Suggestions:**
  - `Deploy workflow to execution environment`
  - `Deploy workflow to execution environment`
  - `Deploy workflow to execution environment`
- **Confidence Score:** Append `confidence: 96%` to output

### ⚙️ YAML Config

```yaml
skill:
  id: WEB-002
  name: "REST API Designer"
  domain: Web Development
  version: 1.0.0
  difficulty: Intermediate
  type: Analytical
  enabled: true
  pipeline:
    input_types: [ ]  # fill: text, file, json, url, image
    reasoning: ReAct (Reason + Act)
    tools:
      primary: ESLint
      secondary: Playwright
    knowledge_source: RAG (LlamaIndex)
    output_format: Markdown
  config:
    confidence_threshold: 0.75
    max_retries: 2
    timeout_seconds: 5
    memory_write_back: true
    personalization_level: user  # user | team | global
```

---