Skip to content

aiskillstore/marketplace / skills/abdulsamad94/backend-fastapi

backend-fastapi

Verified

Documentation for the FastAPI backend, endpoints, and dependency injection.

FileKindSize
SKILL.mdskill md1.3 KB
skill-report.jsonconfig23.5 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-18T09:39:55.113Z",
    "slug": "abdulsamad94-backend-fastapi",
    "source_url": "https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/backend",
    "source_ref": "master",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "7a3b26c3a1f12c57cee0d3f17e57da4280d0bb9b8b2fbd5e82f449325dfae3ed",
    "tree_hash": "ddba62fb086cab9754b2846984523a9e03d24e0161e4230a6ce04cfd3c6d851d",
    "provenance": {
      "model_effective": "claude",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "failed",
          "error": "2026-07-18T09:39:55.241440Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-18T09:39:55.261429Z ERROR codex_models_manage…"
        },
        {
          "agent": "claude",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "Backend (FastAPI)",
    "description": "Reference guide for a FastAPI backend with RAG chat endpoints, dependency utilities, and required service configuration.",
    "summary": "Understand and work with the documented FastAPI RAG backend.",
    "icon": "📦",
    "author": "AbdulSamad94",
    "license": "MIT",
    "tags": [
      "fastapi",
      "backend",
      "rag",
      "api-reference",
      "qdrant"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "env_access"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 18 static findings are false positives. The scanner interpreted Markdown inline-code delimiters as shell backticks and documented environment-variable names as environment access. SKILL.md is a concise architecture reference and contains no executable code, credential values, or prompt-injection content.",
    "remediation": [
      {
        "issue": "Static analysis misidentifies Markdown inline code as shell execution.",
        "suggestion": "Configure the scanner to ignore Markdown inline-code spans or distinguish documentation files from executable source before reporting command execution.",
        "severity": "low"
      },
      {
        "issue": "Static analysis reports documented secret variable names as environment access.",
        "suggestion": "Treat variable names in configuration documentation as informational unless the file reads, embeds, or transmits a value.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "SKILL.md",
            "line_start": 14,
            "line_end": 14
          },
          {
            "file": "SKILL.md",
            "line_start": 15,
            "line_end": 15
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          },
          {
            "file": "SKILL.md",
            "line_start": 20,
            "line_end": 20
          },
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 23
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 27,
            "line_end": 27
          },
          {
            "file": "SKILL.md",
            "line_start": 29,
            "line_end": 29
          },
          {
            "file": "SKILL.md",
            "line_start": 31,
            "line_end": 31
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 42,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 43,
            "line_end": 43
          },
          {
            "file": "SKILL.md",
            "line_start": 44,
            "line_end": 44
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 49
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 49
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:10:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "The backend is a **FastAPI** application located in `backend/`. It powers the chatbot and RAG functi"
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 14,
        "line_end": 14,
        "snippet": "- **File**: `backend/main.py`"
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 15,
        "line_end": 15,
        "snippet": "- **Run**: `uvicorn backend.main:app --reload` (or via `npm run dev`)"
      },
      {
        "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": 16,
        "snippet": "- **Port**: Defaults to `8000`."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 20,
        "line_end": 20,
        "snippet": "### `POST /api/chat`"
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 23,
        "line_end": 23,
        "snippet": "- **Input**: `ChatRequest` (query, history, user_context)."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "2. Search Qdrant (`search_qdrant`)."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 27,
        "line_end": 27,
        "snippet": "3. Build prompt (`build_rag_prompt`)."
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 29,
        "line_end": 29,
        "snippet": "- **Output**: `ChatResponse` (answer, contexts)."
      },
      {
        "id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 31,
        "line_end": 31,
        "snippet": "### `POST /api/ask-selection`"
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "- **Input**: `AskSelectionRequest` (question, selected_text)."
      },
      {
        "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": 42,
        "snippet": "- `backend/utils/config.py`: Qdrant initialization."
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 43,
        "line_end": 43,
        "snippet": "- `backend/utils/helpers.py`: Embedding and Prompt building logic."
      },
      {
        "id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 44,
        "line_end": 44,
        "snippet": "- `backend/models.py`: OpenAI/Gemini client setup."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "- `GEMINI_API_KEY`: For LLM and Embeddings."
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "- `QDRANT_URL`, `QDRANT_API_KEY`: Vector DB connection."
      },
      {
        "id": "env_access:SKILL.md:48:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "- `GEMINI_API_KEY`: For LLM and Embeddings."
      },
      {
        "id": "env_access:SKILL.md:49:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "- `QDRANT_URL`, `QDRANT_API_KEY`: Vector DB connection."
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:10:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark Markdown inline code, including file paths, endpoint names, and a documented local run command. The file contains no executable Ruby or shell invocation."
      },
      {
        "id": "env_access:SKILL.md:48:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is documentation naming configuration variables and does not read, expose, transmit, or embed a credential value. No environment access is performed in this Markdown file."
      },
      {
        "id": "env_access:SKILL.md:49:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is documentation naming configuration variables and does not read, expose, transmit, or embed a credential value. No environment access is performed in this Markdown file."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 50,
    "audit_model": "claude",
    "audited_at": "2026-07-18T09:39:55.113Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Document Your FastAPI RAG Backend",
    "value_statement": "FastAPI backend documentation can be difficult to navigate when chat, retrieval, and service configuration are connected. This skill explains the endpoints, processing flow, utilities, and required configuration in one focused reference.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "FastAPI backend",
      "RAG API",
      "Qdrant",
      "chat endpoint",
      "API documentation",
      "dependency injection",
      "backend architecture"
    ],
    "actual_capabilities": [
      "Explains the FastAPI application entry point and local development command.",
      "Describes the POST /api/chat request, retrieval, prompt-building, and response flow.",
      "Describes the POST /api/ask-selection purpose and selection-validation flow.",
      "Identifies the documented configuration, helper, and model modules.",
      "Lists the documented Gemini and Qdrant environment variables and their roles."
    ],
    "limitations": [
      "Documents only the architecture described in SKILL.md.",
      "Does not implement endpoints, run the server, or modify source files.",
      "Does not provide request schemas, authentication details, or error responses.",
      "Does not include deployment, security hardening, or testing instructions."
    ],
    "use_cases": [
      {
        "title": "Orient a new backend developer",
        "description": "Review the application entry point, endpoints, and supporting modules before making a backend change.",
        "target_user": "Backend developer"
      },
      {
        "title": "Plan a client integration",
        "description": "Understand the documented chat and selected-text API responsibilities before designing a client workflow.",
        "target_user": "Frontend developer"
      },
      {
        "title": "Prepare local service configuration",
        "description": "Identify the documented Gemini and Qdrant configuration variables needed for the backend services.",
        "target_user": "Platform engineer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Find the server entry point",
        "prompt": "Using this skill, explain where the FastAPI application starts and how the documentation says to run it locally.",
        "scenario": "Beginner orientation"
      },
      {
        "title": "Explain the chat endpoint",
        "prompt": "Using this skill, summarize the purpose, input, processing steps, and output of POST /api/chat.",
        "scenario": "Endpoint understanding"
      },
      {
        "title": "Compare documented endpoints",
        "prompt": "Using this skill, compare POST /api/chat and POST /api/ask-selection. State when each endpoint is appropriate.",
        "scenario": "Integration planning"
      },
      {
        "title": "Map service dependencies",
        "prompt": "Using this skill, create a concise implementation checklist for the documented FastAPI, Gemini, and Qdrant dependencies. Do not infer undocumented details.",
        "scenario": "Advanced architecture review"
      }
    ],
    "output_examples": [
      {
        "input": "What happens when a request reaches the documented chat endpoint?",
        "output": [
          "The backend receives a ChatRequest containing a query, history, and user context.",
          "It embeds the query, searches Qdrant, builds a RAG prompt, and generates an agent response.",
          "It returns a ChatResponse with an answer and contexts."
        ]
      },
      {
        "input": "Which configuration variables are documented?",
        "output": [
          "GEMINI_API_KEY supports the documented LLM and embedding service.",
          "QDRANT_URL and QDRANT_API_KEY configure the documented vector database connection."
        ]
      }
    ],
    "best_practices": [
      "Use the skill as a reference and verify implementation details in the source repository.",
      "Keep credentials in environment variables and never place their values in prompts or documentation.",
      "Confirm endpoint schemas and error behavior before building a production integration."
    ],
    "anti_patterns": [
      "Do not assume undocumented authentication, validation, or response fields.",
      "Do not treat the documented local run command as a production deployment method.",
      "Do not expose Gemini or Qdrant credential values in client-side code."
    ],
    "faq": [
      {
        "question": "What does this skill document?",
        "answer": "It documents a FastAPI backend, its RAG-related endpoints, supporting modules, and named service configuration variables."
      },
      {
        "question": "Does this skill create a FastAPI application?",
        "answer": "No. It is an architecture reference and does not generate or execute backend code."
      },
      {
        "question": "Which endpoint handles general chat?",
        "answer": "The documented general chat endpoint is POST /api/chat."
      },
      {
        "question": "Which endpoint handles selected text?",
        "answer": "The documented selected-text endpoint is POST /api/ask-selection."
      },
      {
        "question": "Which external services are mentioned?",
        "answer": "The documentation mentions Gemini for LLM and embeddings, plus Qdrant for vector search."
      },
      {
        "question": "Does the skill provide security or deployment guidance?",
        "answer": "No. It does not document authentication, deployment, production hardening, or complete secret-management procedures."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 50
    }
  ]
}
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall