Add SKILL.md and execution script.

Author: ayushdad609-code

SKILL.md

@@ -0,0 +1,46 @@
+---
+name: git-api-client
+description: Offline-first, Git-native API client for executing and testing API requests stored as Markdown files. Use when you need to interact with APIs, document endpoints, or verify contract compliance without using heavy external tools like Postman.
+---
+
+# Git-Native API Client
+
+This skill allows you to manage API requests as repository-native Markdown files. This ensures that API documentation and test cases live alongside the code, are version-controlled, and can be reviewed via standard Pull Request workflows.
+
+## Workflow
+
+1.  **Identify or Create Request File**: API requests are stored in `.md` files (e.g., `docs/api/get-users.md`).
+2.  **Define Request Structure**:
+    - Use YAML frontmatter for `method`, `url`, and `headers`.
+    - Place the request body (JSON, text, etc.) below the frontmatter.
+    - Support for environment variables using `{{VAR_NAME}}` syntax.
+3.  **Execute Request**: Run the `execute_api_request.py` script to perform the call and see the response.
+
+## File Format Example
+
+```markdown
+---
+method: POST
+url: https://jsonplaceholder.typicode.com/posts
+headers:
+  Content-Type: application/json; charset=UTF-8
+---
+
+{
+  "title": "foo",
+  "body": "bar",
+  "userId": 1
+}
+```
+
+## Tools & Scripts
+
+- **`scripts/execute_api_request.py`**: The primary execution engine.
+  - **Usage**: `python scripts/execute_api_request.py <path_to_file>`
+  - **Environment Variables**: The script automatically substitutes `{{ENV_VAR}}` with values from the current shell environment.
+
+## Best Practices
+
+- **Repository Structure**: Store API requests in a dedicated folder like `docs/api/` or `tests/integration/api/`.
+- **Security**: Never hardcode secrets in the Markdown files. Use `{{API_TOKEN}}` and ensure the token is set in the environment or a `.env` file (which should be in `.gitignore`).
+- **Responses**: When verifying an API, consider appending the response to a sibling `.response.md` file for record-keeping during development.

scripts/execute_api_request.py

@@ -0,0 +1,83 @@
+import sys
+import os
+import json
+import yaml
+import subprocess
+import re
+
+def execute_request(file_path):
+    if not os.path.exists(file_path):
+        print(f"Error: File {file_path} not found.")
+        return
+
+    with open(file_path, 'r') as f:
+        content = f.read()
+
+    # Simple regex to split frontmatter and body
+    match = re.match(r'^---\s*\n(.*?)\n---\s*\n(.*)', content, re.DOTALL)
+    if not match:
+        print("Error: Invalid Markdown format. Missing frontmatter.")
+        return
+
+    frontmatter_raw = match.group(1)
+    body = match.group(2).strip()
+
+    try:
+        config = yaml.safe_load(frontmatter_raw)
+    except yaml.YAMLError as e:
+        print(f"Error: YAML parsing failed: {e}")
+        return
+
+    method = config.get('method', 'GET').upper()
+    url = config.get('url')
+    headers = config.get('headers', {})
+
+    if not url:
+        print("Error: 'url' is required in frontmatter.")
+        return
+
+    # Replace environment variables in URL, headers, and body
+    def replace_env(text):
+        if not isinstance(text, str): return text
+        return re.sub(r'\{\{(.*?)\}\}', lambda m: os.environ.get(m.group(1), m.group(0)), text)
+
+    url = replace_env(url)
+    for k, v in headers.items():
+        headers[k] = replace_env(v)
+    body = replace_env(body)
+
+    # Build curl command
+    curl_cmd = ['curl', '-s', '-i', '-X', method, url]
+    
+    for k, v in headers.items():
+        curl_cmd.extend(['-H', f"{k}: {v}"])
+
+    if body and method in ['POST', 'PUT', 'PATCH']:
+        curl_cmd.extend(['-d', body])
+
+    try:
+        result = subprocess.run(curl_cmd, capture_output=True, text=True, timeout=30)
+        
+        output = result.stdout
+        if result.stderr:
+            output += f"\n--- Stderr ---\n{result.stderr}"
+            
+        # Truncate if too long
+        max_lines = 100
+        lines = output.splitlines()
+        if len(lines) > max_lines:
+            print("\n".join(lines[:max_lines]))
+            print(f"\n... [TRUNCATED {len(lines) - max_lines} LINES] ...")
+        else:
+            print(output)
+
+    except subprocess.TimeoutExpired:
+        print("Error: Request timed out.")
+    except Exception as e:
+        print(f"Error: Execution failed: {e}")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python execute_api_request.py <path_to_markdown_file>")
+    else:
+        execute_request(sys.argv[1])