aiskillstore/marketplace / skills/0xdarkmatter/python-fastapi-patterns
python-fastapi-patterns
VerifiedFastAPI web framework patterns. Triggers on: fastapi, api endpoint, dependency injection, pydantic model, openapi, swagger, starlette, async api, rest api, uvicorn.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| assets/fastapi-template.py | script | 4.9 KB |
| references/background-tasks.md | markdown | 8.4 KB |
| references/dependency-injection.md | markdown | 7.2 KB |
| references/middleware-patterns.md | markdown | 8.8 KB |
| references/validation-serialization.md | markdown | 7.3 KB |
| scripts/scaffold-api.sh | script | 4.1 KB |
| skill-report.json | config | 72.8 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-06T02:02:04.114Z",
"slug": "0xdarkmatter-python-fastapi-patterns",
"source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-fastapi-patterns",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "a3cfdab053c34f441d99d664a12d20025e0855c85810b23c8a5d0ea136d45b13",
"tree_hash": "d0aa516f5ef2927fb3ae701f4a6b6b718d08de629b24da995ebf604c8bf89e44",
"provenance": {
"model_requested": "gpt-5.5:high",
"model_effective": "codex:gpt-5.5:high",
"fallback_chain": [
{
"agent": "codex",
"model": "gpt-5.5",
"effort": "high",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "python-fastapi-patterns",
"description": "FastAPI patterns for Python APIs with routing, validation, dependency injection, middleware, and background task examples.",
"summary": "Build FastAPI services with practical Python API patterns and scaffolded endpoint examples.",
"icon": "📦",
"version": "1.0.0",
"author": "0xDarkMatter",
"license": "MIT",
"tags": [
"fastapi",
"python",
"api-design",
"pydantic",
"async"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"network",
"env_access",
"external_commands"
],
"category": "coding"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Static alerts were reviewed as FastAPI documentation, runnable templates, or a scaffold helper. No evidence found of prompt injection, credential exfiltration, hidden network calls, destructive commands, or unauthorized environment access. The examples still need production hardening before users copy them into live services.",
"remediation": [
{
"issue": "Placeholder secrets and connection strings can be copied into production code.",
"suggestion": "Label placeholders clearly and replace sample secrets, database URLs, Redis URLs, and example domains before deployment.",
"severity": "low"
},
{
"issue": "The scaffold helper accepts any resource name and inserts it into generated text.",
"suggestion": "Validate resource names as Python identifiers before printing generated router and model names.",
"severity": "low"
},
{
"issue": "Development CORS and Uvicorn examples can expose services if used unchanged.",
"suggestion": "Document production-safe origins, disable reload in deployed processes, and bind only as required by the runtime environment.",
"severity": "low"
}
],
"risk_factor_evidence": [
{
"factor": "network",
"evidence": [
{
"file": "assets/fastapi-template.py",
"line_start": 78,
"line_end": 78
},
{
"file": "assets/fastapi-template.py",
"line_start": 6,
"line_end": 6
},
{
"file": "assets/fastapi-template.py",
"line_start": 180,
"line_end": 180
},
{
"file": "references/dependency-injection.md",
"line_start": 172,
"line_end": 172
},
{
"file": "references/middleware-patterns.md",
"line_start": 44,
"line_end": 44
},
{
"file": "references/middleware-patterns.md",
"line_start": 45,
"line_end": 45
}
]
},
{
"factor": "env_access",
"evidence": [
{
"file": "assets/fastapi-template.py",
"line_start": 28,
"line_end": 28
},
{
"file": "assets/fastapi-template.py",
"line_start": 29,
"line_end": 29
},
{
"file": "assets/fastapi-template.py",
"line_start": 53,
"line_end": 53
},
{
"file": "assets/fastapi-template.py",
"line_start": 54,
"line_end": 54
},
{
"file": "assets/fastapi-template.py",
"line_start": 30,
"line_end": 30
},
{
"file": "references/background-tasks.md",
"line_start": 189,
"line_end": 189
},
{
"file": "references/background-tasks.md",
"line_start": 190,
"line_end": 190
},
{
"file": "references/dependency-injection.md",
"line_start": 129,
"line_end": 129
},
{
"file": "references/dependency-injection.md",
"line_start": 130,
"line_end": 130
},
{
"file": "references/dependency-injection.md",
"line_start": 142,
"line_end": 142
},
{
"file": "references/dependency-injection.md",
"line_start": 131,
"line_end": 131
},
{
"file": "references/dependency-injection.md",
"line_start": 274,
"line_end": 274
},
{
"file": "references/dependency-injection.md",
"line_start": 275,
"line_end": 275
},
{
"file": "references/dependency-injection.md",
"line_start": 277,
"line_end": 277
},
{
"file": "references/dependency-injection.md",
"line_start": 280,
"line_end": 280
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "scripts/scaffold-api.sh",
"line_start": 18,
"line_end": 18
},
{
"file": "scripts/scaffold-api.sh",
"line_start": 19,
"line_end": 19
},
{
"file": "scripts/scaffold-api.sh",
"line_start": 20,
"line_end": 20
},
{
"file": "SKILL.md",
"line_start": 16,
"line_end": 38
},
{
"file": "SKILL.md",
"line_start": 38,
"line_end": 42
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 65
},
{
"file": "SKILL.md",
"line_start": 65,
"line_end": 69
},
{
"file": "SKILL.md",
"line_start": 69,
"line_end": 86
},
{
"file": "SKILL.md",
"line_start": 86,
"line_end": 90
},
{
"file": "SKILL.md",
"line_start": 90,
"line_end": 116
},
{
"file": "SKILL.md",
"line_start": 116,
"line_end": 120
},
{
"file": "SKILL.md",
"line_start": 120,
"line_end": 143
},
{
"file": "SKILL.md",
"line_start": 143,
"line_end": 147
},
{
"file": "SKILL.md",
"line_start": 147,
"line_end": 166
},
{
"file": "SKILL.md",
"line_start": 166,
"line_end": 172
},
{
"file": "SKILL.md",
"line_start": 172,
"line_end": 173
},
{
"file": "SKILL.md",
"line_start": 173,
"line_end": 174
},
{
"file": "SKILL.md",
"line_start": 174,
"line_end": 175
},
{
"file": "SKILL.md",
"line_start": 175,
"line_end": 176
},
{
"file": "SKILL.md",
"line_start": 176,
"line_end": 177
},
{
"file": "SKILL.md",
"line_start": 177,
"line_end": 178
},
{
"file": "SKILL.md",
"line_start": 178,
"line_end": 182
},
{
"file": "SKILL.md",
"line_start": 182,
"line_end": 183
},
{
"file": "SKILL.md",
"line_start": 183,
"line_end": 184
},
{
"file": "SKILL.md",
"line_start": 184,
"line_end": 185
},
{
"file": "SKILL.md",
"line_start": 185,
"line_end": 189
},
{
"file": "SKILL.md",
"line_start": 189,
"line_end": 193
},
{
"file": "SKILL.md",
"line_start": 193,
"line_end": 200
},
{
"file": "SKILL.md",
"line_start": 200,
"line_end": 201
},
{
"file": "SKILL.md",
"line_start": 201,
"line_end": 204
},
{
"file": "SKILL.md",
"line_start": 204,
"line_end": 205
},
{
"file": "SKILL.md",
"line_start": 205,
"line_end": 206
}
]
}
],
"static_findings": [
{
"id": "network:assets/fastapi-template.py:78:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "assets/fastapi-template.py",
"line_start": 78,
"line_end": 78,
"snippet": "allow_origins=[\"*\"] if get_settings().debug else [\"https://myapp.com\"],"
},
{
"id": "network:assets/fastapi-template.py:6:hardcoded-ip-address",
"category": "network",
"severity": "medium",
"pattern": "Hardcoded IP address",
"file": "assets/fastapi-template.py",
"line_start": 6,
"line_end": 6,
"snippet": "uvicorn main:app --host 0.0.0.0 --port 8000 # Production"
},
{
"id": "network:assets/fastapi-template.py:180:hardcoded-ip-address",
"category": "network",
"severity": "medium",
"pattern": "Hardcoded IP address",
"file": "assets/fastapi-template.py",
"line_start": 180,
"line_end": 180,
"snippet": "uvicorn.run(\"main:app\", host=\"0.0.0.0\", port=8000, reload=True)"
},
{
"id": "env_access:assets/fastapi-template.py:28:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "assets/fastapi-template.py",
"line_start": 28,
"line_end": 28,
"snippet": "database_url: str = \"postgresql+asyncpg://user:pass@localhost/db\""
},
{
"id": "env_access:assets/fastapi-template.py:29:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "assets/fastapi-template.py",
"line_start": 29,
"line_end": 29,
"snippet": "redis_url: str = \"redis://localhost:6379/0\""
},
{
"id": "env_access:assets/fastapi-template.py:53:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "assets/fastapi-template.py",
"line_start": 53,
"line_end": 53,
"snippet": "# app.state.db = await create_db_pool(settings.database_url)"
},
{
"id": "env_access:assets/fastapi-template.py:54:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "assets/fastapi-template.py",
"line_start": 54,
"line_end": 54,
"snippet": "# app.state.redis = await create_redis_client(settings.redis_url)"
},
{
"id": "env_access:assets/fastapi-template.py:30:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "assets/fastapi-template.py",
"line_start": 30,
"line_end": 30,
"snippet": "api_key: str = \"\""
},
{
"id": "sensitive:assets/fastapi-template.py:32:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "assets/fastapi-template.py",
"line_start": 32,
"line_end": 32,
"snippet": "model_config = {\"env_file\": \".env\", \"env_file_encoding\": \"utf-8\"}"
},
{
"id": "sensitive:assets/fastapi-template.py:53:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "assets/fastapi-template.py",
"line_start": 53,
"line_end": 53,
"snippet": "# app.state.db = await create_db_pool(settings.database_url)"
},
{
"id": "sensitive:assets/fastapi-template.py:60:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "assets/fastapi-template.py",
"line_start": 60,
"line_end": 60,
"snippet": "# await app.state.db.close()"
},
{
"id": "env_access:references/background-tasks.md:189:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "references/background-tasks.md",
"line_start": 189,
"line_end": 189,
"snippet": "def __init__(self, redis_url: str):"
},
{
"id": "env_access:references/background-tasks.md:190:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "references/background-tasks.md",
"line_start": 190,
"line_end": 190,
"snippet": "self.redis = redis.from_url(redis_url)"
},
{
"id": "blocker:references/background-tasks.md:59:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 59,
"line_end": 60,
"snippet": "action, user_id"
},
{
"id": "blocker:references/background-tasks.md:186:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 186,
"line_end": 186,
"snippet": "from uuid import uuid4"
},
{
"id": "blocker:references/background-tasks.md:195:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 195,
"line_end": 195,
"snippet": "task_id = str(uuid4())"
},
{
"id": "blocker:references/background-tasks.md:204:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 204,
"line_end": 206,
"snippet": "return task_id"
},
{
"id": "blocker:references/background-tasks.md:240:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 240,
"line_end": 240,
"snippet": "task_id = await queue.enqueue(task_type, payload)"
},
{
"id": "blocker:references/background-tasks.md:267:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 267,
"line_end": 267,
"snippet": "if task_id in self._tasks:"
},
{
"id": "blocker:references/background-tasks.md:280:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 280,
"line_end": 282,
"snippet": "return task_id"
},
{
"id": "blocker:references/background-tasks.md:283:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 283,
"line_end": 283,
"snippet": "if task_id in self._tasks:"
},
{
"id": "blocker:references/background-tasks.md:300:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/background-tasks.md",
"line_start": 300,
"line_end": 300,
"snippet": "task_id = str(uuid4())"
},
{
"id": "network:references/dependency-injection.md:172:http-client-library",
"category": "network",
"severity": "low",
"pattern": "HTTP client library",
"file": "references/dependency-injection.md",
"line_start": 172,
"line_end": 172,
"snippet": "async def trace_request(request_id: Annotated[str, Depends(get_request_id)]):"
},
{
"id": "env_access:references/dependency-injection.md:129:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "references/dependency-injection.md",
"line_start": 129,
"line_end": 129,
"snippet": "database_url: str"
},
{
"id": "env_access:references/dependency-injection.md:130:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "references/dependency-injection.md",
"line_start": 130,
"line_end": 130,
"snippet": "redis_url: str"
},
{
"id": "env_access:references/dependency-injection.md:142:database-connection-strings",
"category": "env_access",
"severity": "high",
"pattern": "Database connection strings",
"file": "references/dependency-injection.md",
"line_start": 142,
"line_end": 142,
"snippet": "engine = create_async_engine(settings.database_url)"
},
{
"id": "env_access:references/dependency-injection.md:131:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "references/dependency-injection.md",
"line_start": 131,
"line_end": 131,
"snippet": "api_key: str"
},
{
"id": "env_access:references/dependency-injection.md:274:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "references/dependency-injection.md",
"line_start": 274,
"line_end": 274,
"snippet": "async def get_api_key(x_api_key: Annotated[str, Header()]):"
},
{
"id": "env_access:references/dependency-injection.md:275:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "references/dependency-injection.md",
"line_start": 275,
"line_end": 275,
"snippet": "if x_api_key != \"secret\":"
},
{
"id": "env_access:references/dependency-injection.md:277:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "references/dependency-injection.md",
"line_start": 277,
"line_end": 277,
"snippet": "return x_api_key"
},
{
"id": "env_access:references/dependency-injection.md:280:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "references/dependency-injection.md",
"line_start": 280,
"line_end": 280,
"snippet": "api_v1 = FastAPI(dependencies=[Depends(get_api_key)])"
},
{
"id": "sensitive:references/dependency-injection.md:133:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "references/dependency-injection.md",
"line_start": 133,
"line_end": 133,
"snippet": "model_config = {\"env_file\": \".env\"}"
},
{
"id": "sensitive:references/dependency-injection.md:103:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "references/dependency-injection.md",
"line_start": 103,
"line_end": 103,
"snippet": "self.db = db"
},
{
"id": "sensitive:references/dependency-injection.md:106:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "references/dependency-injection.md",
"line_start": 106,
"line_end": 106,
"snippet": "result = await self.db.execute("
},
{
"id": "blocker:references/dependency-injection.md:107:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/dependency-injection.md",
"line_start": 107,
"line_end": 107,
"snippet": "select(User).where(User.id == user_id)"
},
{
"id": "blocker:references/dependency-injection.md:152:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/dependency-injection.md",
"line_start": 152,
"line_end": 152,
"snippet": "from uuid import uuid4"
},
{
"id": "blocker:references/dependency-injection.md:159:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/dependency-injection.md",
"line_start": 159,
"line_end": 159,
"snippet": "request_id = str(uuid4())"
},
{
"id": "blocker:references/dependency-injection.md:161:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/dependency-injection.md",
"line_start": 161,
"line_end": 161,
"snippet": "request.state.request_id = request_id"
},
{
"id": "blocker:references/dependency-injection.md:164:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/dependency-injection.md",
"line_start": 164,
"line_end": 165,
"snippet": "response.headers[\"X-Request-ID\"] = request_id"
},
{
"id": "network:references/middleware-patterns.md:44:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "references/middleware-patterns.md",
"line_start": 44,
"line_end": 44,
"snippet": "\"http://localhost:3000\","
},
{
"id": "network:references/middleware-patterns.md:45:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "references/middleware-patterns.md",
"line_start": 45,
"line_end": 45,
"snippet": "\"https://myapp.com\","
},
{
"id": "blocker:references/middleware-patterns.md:101:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/middleware-patterns.md",
"line_start": 101,
"line_end": 101,
"snippet": "from uuid import uuid4"
},
{
"id": "blocker:references/middleware-patterns.md:109:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/middleware-patterns.md",
"line_start": 109,
"line_end": 109,
"snippet": "request_id = request.headers.get(\"X-Request-ID\") or str(uuid4())"
},
{
"id": "blocker:references/middleware-patterns.md:113:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/middleware-patterns.md",
"line_start": 113,
"line_end": 113,
"snippet": "request.state.request_id = request_id"
},
{
"id": "blocker:references/middleware-patterns.md:116:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/middleware-patterns.md",
"line_start": 116,
"line_end": 118,
"snippet": "response.headers[\"X-Request-ID\"] = request_id"
},
{
"id": "external_commands:scripts/scaffold-api.sh:18:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "scripts/scaffold-api.sh",
"line_start": 18,
"line_end": 18,
"snippet": "RESOURCE_LOWER=$(echo \"$RESOURCE\" | tr '[:upper:]' '[:lower:]')"
},
{
"id": "external_commands:scripts/scaffold-api.sh:19:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "scripts/scaffold-api.sh",
"line_start": 19,
"line_end": 19,
"snippet": "RESOURCE_UPPER=$(echo \"$RESOURCE\" | tr '[:lower:]' '[:upper:]')"
},
{
"id": "external_commands:scripts/scaffold-api.sh:20:shell-command-substitution",
"category": "external_commands",
"severity": "medium",
"pattern": "Shell command substitution",
"file": "scripts/scaffold-api.sh",
"line_start": 20,
"line_end": 20,
"snippet": "RESOURCE_TITLE=$(echo \"$RESOURCE_LOWER\" | sed 's/\\b\\(.\\)/\\u\\1/g')"
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 16,
"line_end": 38,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 38,
"line_end": 42,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 65,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 65,
"line_end": 69,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 69,
"line_end": 86,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 86,
"line_end": 90,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:90:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 90,
"line_end": 116,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 116,
"line_end": 120,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 120,
"line_end": 143,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 143,
"line_end": 147,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 147,
"line_end": 166,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 166,
"line_end": 172,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 172,
"line_end": 173,
"snippet": "| Path param | `@app.get(\"/items/{id}\")` |"
},
{
"id": "external_commands:SKILL.md:173:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 173,
"line_end": 174,
"snippet": "| Query param | `def f(q: str = None)` |"
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 174,
"line_end": 175,
"snippet": "| Body | `def f(item: ItemCreate)` |"
},
{
"id": "external_commands:SKILL.md:175:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 175,
"line_end": 176,
"snippet": "| Dependency | `Depends(get_db)` |"
},
{
"id": "external_commands:SKILL.md:176:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 176,
"line_end": 177,
"snippet": "| Auth | `Depends(get_current_user)` |"
},
{
"id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 177,
"line_end": 178,
"snippet": "| Response model | `response_model=ItemResponse` |"
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 178,
"line_end": 182,
"snippet": "| Status code | `status_code=201` |"
},
{
"id": "external_commands:SKILL.md:182:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 182,
"line_end": 183,
"snippet": "- `./references/dependency-injection.md` - Advanced DI patterns, scopes, caching"
},
{
"id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 183,
"line_end": 184,
"snippet": "- `./references/middleware-patterns.md` - Middleware chains, CORS, error handling"
},
{
"id": "external_commands:SKILL.md:184:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 184,
"line_end": 185,
"snippet": "- `./references/validation-serialization.md` - Pydantic v2 patterns, custom validators"
},
{
"id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 185,
"line_end": 189,
"snippet": "- `./references/background-tasks.md` - Background tasks, async workers, scheduling"
},
{
"id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 189,
"line_end": 193,
"snippet": "- `./scripts/scaffold-api.sh` - Generate API endpoint boilerplate"
},
{
"id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 193,
"line_end": 200,
"snippet": "- `./assets/fastapi-template.py` - Production-ready FastAPI app skeleton"
},
{
"id": "external_commands:SKILL.md:200:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 200,
"line_end": 201,
"snippet": "- `python-typing-patterns` - Pydantic models and type hints"
},
{
"id": "external_commands:SKILL.md:201:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 201,
"line_end": 204,
"snippet": "- `python-async-patterns` - Async endpoint patterns"
},
{
"id": "external_commands:SKILL.md:204:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 204,
"line_end": 205,
"snippet": "- `python-database-patterns` - SQLAlchemy integration"
},
{
"id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 205,
"line_end": 206,
"snippet": "- `python-observability-patterns` - Logging, metrics, tracing middleware"
},
{
"id": "sensitive:SKILL.md:24:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "SKILL.md",
"line_start": 24,
"line_end": 24,
"snippet": "app.state.db = await create_db_pool()"
},
{
"id": "sensitive:SKILL.md:27:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "SKILL.md",
"line_start": 27,
"line_end": 27,
"snippet": "await app.state.db.close()"
},
{
"id": "blocker:SKILL.md:106:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 106,
"line_end": 106,
"snippet": "raise HTTPException(status_code=401, detail=\"Invalid token\")"
},
{
"id": "blocker:SKILL.md:135:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 135,
"line_end": 135,
"snippet": "self.item_id = item_id"
}
],
"finding_verdicts": [
{
"id": "network:assets/fastapi-template.py:78:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This is a CORS configuration example with a placeholder production origin and debug-only wildcard. It does not make a network request or send data externally."
},
{
"id": "network:assets/fastapi-template.py:6:hardcoded-ip-address",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The 0.0.0.0 value documents how to bind Uvicorn in production. It is not a hardcoded remote address or data destination."
},
{
"id": "network:assets/fastapi-template.py:180:hardcoded-ip-address",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The 0.0.0.0 value is a Uvicorn bind address in a runnable template, not a remote host. It exposes the sample app when run but is not hidden networking."
},
{
"id": "env_access:assets/fastapi-template.py:28:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.89,
"reason": "The connection value is a localhost placeholder in a FastAPI settings template. No real credential is present and the skill does not exfiltrate it."
},
{
"id": "env_access:assets/fastapi-template.py:29:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.89,
"reason": "The connection value is a localhost placeholder in a FastAPI settings template. No real credential is present and the skill does not exfiltrate it."
},
{
"id": "env_access:assets/fastapi-template.py:53:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The line is commented template wiring for app database or Redis clients. It does not execute, read secrets, or transfer credentials."
},
{
"id": "env_access:assets/fastapi-template.py:54:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The line is commented template wiring for app database or Redis clients. It does not execute, read secrets, or transfer credentials."
},
{
"id": "env_access:assets/fastapi-template.py:30:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The api_key field is an empty settings placeholder in a template. It is not a real key and is not read or transmitted by the skill."
},
{
"id": "sensitive:assets/fastapi-template.py:32:environment-file-access",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The .env reference is Pydantic BaseSettings configuration for user applications. The skill does not read local environment files for itself or transmit their contents."
},
{
"id": "sensitive:assets/fastapi-template.py:53:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The snippet references a db variable or database session in FastAPI examples, not a SQLite file path. There is no file access or database extraction behavior."
},
{
"id": "sensitive:assets/fastapi-template.py:60:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The snippet references a db variable or database session in FastAPI examples, not a SQLite file path. There is no file access or database extraction behavior."
},
{
"id": "env_access:references/background-tasks.md:189:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The Redis URL appears in documentation for a task queue constructor. It is normal application configuration, not hidden environment access by the skill."
},
{
"id": "env_access:references/background-tasks.md:190:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The Redis URL appears in documentation for a task queue constructor. It is normal application configuration, not hidden environment access by the skill."
},
{
"id": "blocker:references/background-tasks.md:59:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:186:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:195:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:204:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:240:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:267:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:280:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:283:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/background-tasks.md:300:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "network:references/dependency-injection.md:172:http-client-library",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line defines a trace endpoint that returns a request ID dependency. It does not import an HTTP client or make any outbound request."
},
{
"id": "env_access:references/dependency-injection.md:129:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The database or Redis value is part of a dependency injection example for app settings. It shows configuration flow and does not include real secrets or exfiltration."
},
{
"id": "env_access:references/dependency-injection.md:130:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The database or Redis value is part of a dependency injection example for app settings. It shows configuration flow and does not include real secrets or exfiltration."
},
{
"id": "env_access:references/dependency-injection.md:142:database-connection-strings",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The database or Redis value is part of a dependency injection example for app settings. It shows configuration flow and does not include real secrets or exfiltration."
},
{
"id": "env_access:references/dependency-injection.md:131:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is an API key field or dependency name in documentation. It describes request authentication and does not contain or expose an actual secret."
},
{
"id": "env_access:references/dependency-injection.md:274:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is an API key field or dependency name in documentation. It describes request authentication and does not contain or expose an actual secret."
},
{
"id": "env_access:references/dependency-injection.md:275:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.78,
"reason": "The string secret is a minimal documentation placeholder for an API key comparison. It should be replaced for production, but it is not a real embedded credential."
},
{
"id": "env_access:references/dependency-injection.md:277:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is an API key field or dependency name in documentation. It describes request authentication and does not contain or expose an actual secret."
},
{
"id": "env_access:references/dependency-injection.md:280:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is an API key field or dependency name in documentation. It describes request authentication and does not contain or expose an actual secret."
},
{
"id": "sensitive:references/dependency-injection.md:133:environment-file-access",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The .env reference is Pydantic BaseSettings configuration for user applications. The skill does not read local environment files for itself or transmit their contents."
},
{
"id": "sensitive:references/dependency-injection.md:103:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The snippet references a db variable or database session in FastAPI examples, not a SQLite file path. There is no file access or database extraction behavior."
},
{
"id": "sensitive:references/dependency-injection.md:106:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The snippet references a db variable or database session in FastAPI examples, not a SQLite file path. There is no file access or database extraction behavior."
},
{
"id": "blocker:references/dependency-injection.md:107:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/dependency-injection.md:152:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/dependency-injection.md:159:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/dependency-injection.md:161:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/dependency-injection.md:164:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "network:references/middleware-patterns.md:44:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.92,
"reason": "The URL appears in documented CORS origin examples for a local frontend and placeholder production domain. It is not an outbound request or exfiltration endpoint."
},
{
"id": "network:references/middleware-patterns.md:45:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.92,
"reason": "The URL appears in documented CORS origin examples for a local frontend and placeholder production domain. It is not an outbound request or exfiltration endpoint."
},
{
"id": "blocker:references/middleware-patterns.md:101:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/middleware-patterns.md:109:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/middleware-patterns.md:113:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "blocker:references/middleware-patterns.md:116:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The match is an application-level user, request, or task identifier inside documentation examples. It is not host reconnaissance or collection of system information."
},
{
"id": "external_commands:scripts/scaffold-api.sh:18:shell-command-substitution",
"verdict": "false_positive",
"confidence": 0.84,
"reason": "The scaffold script uses fixed echo, tr, and sed transformations with quoted input to derive names. It prints boilerplate and does not eval input, write files, or execute generated code."
},
{
"id": "external_commands:scripts/scaffold-api.sh:19:shell-command-substitution",
"verdict": "false_positive",
"confidence": 0.84,
"reason": "The scaffold script uses fixed echo, tr, and sed transformations with quoted input to derive names. It prints boilerplate and does not eval input, write files, or execute generated code."
},
{
"id": "external_commands:scripts/scaffold-api.sh:20:shell-command-substitution",
"verdict": "false_positive",
"confidence": 0.84,
"reason": "The scaffold script uses fixed echo, tr, and sed transformations with quoted input to derive names. It prints boilerplate and does not eval input, write files, or execute generated code."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:90:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The match is a Markdown code fence around Python examples, not Ruby or shell backtick execution. Markdown fences are documentation and are not executed by the skill."
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:173:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:175:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:176:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:182:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:184:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:200:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:201:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:204:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The backticks are inline Markdown formatting for API examples, file paths, or related skill names. They are not executable shell backticks."
},
{
"id": "sensitive:SKILL.md:24:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The snippet references a db variable or database session in FastAPI examples, not a SQLite file path. There is no file access or database extraction behavior."
},
{
"id": "sensitive:SKILL.md:27:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The snippet references a db variable or database session in FastAPI examples, not a SQLite file path. There is no file access or database extraction behavior."
},
{
"id": "blocker:SKILL.md:106:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line is ordinary FastAPI example code, such as an HTTP exception or item identifier assignment. It does not inspect the host system or gather reconnaissance data."
},
{
"id": "blocker:SKILL.md:135:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line is ordinary FastAPI example code, such as an HTTP exception or item identifier assignment. It does not inspect the host system or gather reconnaissance data."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 7,
"total_lines": 1781,
"audit_model": "codex",
"audited_at": "2026-07-06T02:02:04.114Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Build FastAPI APIs with Reusable Patterns",
"value_statement": "FastAPI projects need consistent choices for validation, dependencies, middleware, and background work. This skill gives Claude, Codex, and Claude Code reusable patterns for practical Python API development.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"FastAPI patterns",
"Python API development",
"Pydantic validation",
"FastAPI dependency injection",
"FastAPI middleware",
"async Python APIs",
"REST API scaffolding"
],
"actual_capabilities": [
"Shows FastAPI application setup with lifespan startup and shutdown patterns.",
"Provides request and response model examples using Pydantic v2 validation.",
"Explains dependency injection for settings, database sessions, authentication, permissions, and request state.",
"Documents middleware for CORS, request IDs, logging, security headers, error handling, and rate limits.",
"Covers background task patterns using BackgroundTasks, Celery, APScheduler, Redis queues, and asyncio tasks.",
"Includes a Bash helper that prints CRUD endpoint boilerplate for a named resource."
],
"limitations": [
"Examples use placeholders and need project-specific review before production.",
"No complete auth, migration, deployment, or test suite is included.",
"The scaffold helper prints boilerplate but does not validate Python identifier names.",
"Some examples assume async SQLAlchemy, Redis, or Celery setup from the host project."
],
"use_cases": [
{
"target_user": "Backend developers",
"title": "Create a new API service",
"description": "Start a FastAPI project with clear routing, settings, validation, and lifecycle patterns."
},
{
"target_user": "Platform engineers",
"title": "Standardize service conventions",
"description": "Use shared examples for middleware, request IDs, CORS, security headers, and operational behavior."
},
{
"target_user": "Python learners",
"title": "Study FastAPI architecture",
"description": "Learn how dependencies, Pydantic models, routers, and background tasks fit together."
}
],
"prompt_templates": [
{
"title": "Create a starter API",
"scenario": "Beginner setup for a new FastAPI project",
"prompt": "Create a small FastAPI service with a health endpoint, Pydantic response model, and lifespan hooks."
},
{
"title": "Add validated models",
"scenario": "Request and response design with Pydantic v2",
"prompt": "Design request and response models for a user resource with email validation and safe response fields."
},
{
"title": "Wire dependencies",
"scenario": "Shared resources and authenticated routes",
"prompt": "Add dependency injection for settings, an async database session, current user lookup, and admin access."
},
{
"title": "Design production middleware",
"scenario": "Advanced service behavior and operations",
"prompt": "Create middleware for CORS, request IDs, structured logging, security headers, errors, and rate limits."
}
],
"output_examples": [
{
"input": "Create a FastAPI user creation endpoint with validation.",
"output": "A structured endpoint design with create and response models, email validation, success status, and a database creation placeholder."
},
{
"input": "Add middleware for a frontend application and request tracing.",
"output": "A middleware plan with explicit frontend origins, request ID propagation, response headers, and structured logging fields."
},
{
"input": "Explain how to run long processing jobs from an API.",
"output": "A background processing outline that queues work, returns a task identifier, and exposes a status endpoint."
}
],
"best_practices": [
"Keep request models, response models, and database models separate when data exposure matters.",
"Use dependency injection for shared settings, database sessions, caches, and authenticated users.",
"Replace all placeholder URLs, secrets, CORS origins, and debug settings before deployment."
],
"anti_patterns": [
"Do not copy wildcard CORS settings into production services without review.",
"Do not hardcode real database passwords, API keys, or shared secrets in source files.",
"Do not expose raw exception details or tracebacks in public API responses."
],
"faq": [
{
"question": "Which FastAPI version does this skill target?",
"answer": "It targets modern FastAPI patterns with Pydantic v2 and Python 3.10 or newer."
},
{
"question": "Does it create a complete application?",
"answer": "It provides templates and examples. You must add project structure, database models, and deployment settings."
},
{
"question": "Can I use it with SQLAlchemy?",
"answer": "Yes. The dependency examples fit async SQLAlchemy when you provide the session factory and models."
},
{
"question": "Does the scaffold script modify files?",
"answer": "No. The script prints endpoint boilerplate to standard output for review and manual integration."
},
{
"question": "Are the sample secrets production ready?",
"answer": "No. Placeholder strings must be replaced with environment-managed secrets and service-specific configuration."
},
{
"question": "Does it include testing patterns?",
"answer": "It includes dependency override examples for tests, but full API test suites are outside this skill."
}
]
},
"file_structure": [
{
"name": "assets",
"type": "dir",
"path": "assets",
"children": [
{
"name": "fastapi-template.py",
"type": "file",
"path": "assets/fastapi-template.py",
"lines": 181
}
]
},
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "background-tasks.md",
"type": "file",
"path": "references/background-tasks.md",
"lines": 325
},
{
"name": "dependency-injection.md",
"type": "file",
"path": "references/dependency-injection.md",
"lines": 302
},
{
"name": "middleware-patterns.md",
"type": "file",
"path": "references/middleware-patterns.md",
"lines": 322
},
{
"name": "validation-serialization.md",
"type": "file",
"path": "references/validation-serialization.md",
"lines": 321
}
]
},
{
"name": "scripts",
"type": "dir",
"path": "scripts",
"children": [
{
"name": "scaffold-api.sh",
"type": "file",
"path": "scripts/scaffold-api.sh",
"lines": 123
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 207
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |