# Document FastAPI Backend Architecture

Teams need clear backend context before changing chatbot and RAG services. This skill summarizes FastAPI endpoints, dependencies, run commands, and service configuration in one focused guide.

## Install

```bash
npx skillstore add abdulsamad94/backend-fastapi
```

## Metadata

- - Status: approved
- - Slug: abdulsamad94-backend-fastapi
- - Version: 1.0.0
- - Author: AbdulSamad94
- - GitHub username: AbdulSamad94
- - License: MIT
- - Repository: https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/backend
- - Ref: master
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: low
- - Risk factors: external\_commands, env\_access
- - Quality score: 80
- - Quality tier: silver
- - Public page: https://skillstore.pages.dev/skills/abdulsamad94-backend-fastapi
- - Manifest: https://skillstore.pages.dev/api/skills/abdulsamad94-backend-fastapi/manifest

## Capabilities

- Identifies the FastAPI application entry point and default local port.
- Documents the main chat endpoint and its request and response flow.
- Explains the selected-text question endpoint and validation step.
- Lists backend utility modules for configuration, embeddings, prompts, and model setup.
- Names required Gemini and Qdrant environment variables for service configuration.

## Use Cases

- Onboard Backend Contributors: Help new engineers understand the FastAPI entry point, endpoint flow, and supporting modules before editing the service.
- Prepare API Documentation: Turn the documented endpoint behavior into concise project notes for chatbot and selected-text question workflows.
- Review RAG Service Dependencies: Check which services and environment variables are expected before running or troubleshooting the backend locally.

## Prompt Templates

### Summarize the Backend

```
Use the backend-fastapi skill to summarize the FastAPI backend, its entry point, main endpoints, and required services.
```

### Explain Endpoint Flow

```
Use the backend-fastapi skill to explain the request, processing steps, and response for /api/chat and /api/ask-selection.
```

### Create Onboarding Notes

```
Use the backend-fastapi skill to create concise onboarding notes for a developer joining this chatbot backend project.
```

### Audit Dependency Assumptions

```
Use the backend-fastapi skill to identify backend dependency assumptions, required environment variables, and gaps to verify in source code.
```

## Limitations

- It is documentation only and does not inspect the actual backend source files.
- It does not create, modify, or test FastAPI routes.
- It does not validate API keys, Qdrant connectivity, or model credentials.
- It covers the documented backend structure only, not deployment or monitoring.

## Best Practices

- Use this skill as a starting point, then verify details against the live backend source.
- Keep API keys in environment variables or secret stores, never in prompts or documentation output.
- Pair endpoint summaries with tests or OpenAPI output when preparing release documentation.

## Anti Patterns

- Do not assume this documentation proves the backend currently runs.
- Do not paste real Gemini or Qdrant secrets into prompts.
- Do not use the listed local run command as a production deployment method.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T04:21:19.842\+00:00
- - Summary: Static analysis flagged Markdown backticks, environment variable names, and one weak-cryptography pattern. Review found documentation text only: local run examples, endpoint names, file names, and required secret variable names, with no executable code, secret reading, network exfiltration, or prompt injection. The skill is safe to publish with low residual risk from documented operational commands and secret configuration names.

## Stats

- - Views: 274
- - Downloads: 6
- - Favorites: 0
- - Popularity score: 0