home / skills / bankkroll / skills-builder / flask

flask skill

/skills/flask

This skill helps you answer Flask documentation questions by citing relevant sections on patterns, tutorials, and core concepts.

npx playbooks add skill bankkroll/skills-builder --skill flask

Review the files below or copy the command above to add this skill to your agents.

Files (14)
SKILL.md
3.2 KB
---
name: "flask-docs"
description: "Scraped from https://flask.palletsprojects.com/en/stable/ Source: https://flask.palletsprojects.com/en/stable/. Use when questions involve: patterns, tutorial."
---

# Flask Docs

> Official documentation: https://flask.palletsprojects.com/en/stable/

## Overview

This skill provides comprehensive documentation for flask docs.

**Total references:** 13 files (~122,663 tokens)

**Topics covered:**
Index, Configuring from Python Files, Sessions, Creating a Request Context, Streaming, Login, Further Improving the Shell Experience, Return JSON from Views, Application Object, Working with this Document, Builtin Configuration Values, Version 231...

## Reference Files

Load only the reference files relevant to the user's question:

### General

- **[API¶](references/general-1.md)** (~38,538 tokens)
  - Topics: Application Object, Blueprint Objects, Incoming Request Data
- **[The Application Context¶ and more](references/general-2.md)** (~4,015 tokens)
  - Topics: Purpose of the Context, Lifetime of the Context, Manually Push a Context
- **[Changes¶](references/general-3.md)** (~12,335 tokens)
  - Topics: Version 312, Version 311, Version 310
- **[Command Line Interface¶ and more](references/general-4.md)** (~7,536 tokens)
  - Topics: Application Discovery, Run the Development Server, Open a Shell
- **[Debugging Application Errors¶ and more](references/general-5.md)** (~6,558 tokens)
  - Topics: In Production, The Built-In Debugger, External Debuggers
- **[Flask Extension Development¶ and more](references/general-6.md)** (~7,233 tokens)
  - Topics: Naming, The Extension Class and Initialization, Adding Behavior
- **[Logging¶ and more](references/general-7.md)** (~7,066 tokens)
  - Topics: Basic Configuration, Email Errors to Admins, Injecting Request Information
- **[The Request Context¶ and more](references/general-8.md)** (~7,580 tokens)
  - Topics: Purpose of the Context, Lifetime of the Context, Manually Push a Context
- **[Class and more](references/general-9.md)** (~3,892 tokens)
  - Topics: Basic Reusable View, URL Variables, View Lifetime andself

### Patterns

- **[Application Dispatching¶ and more](references/patterns-1.md)** (~7,592 tokens)
  - Topics: Working with this Document, Combining Applications, Dispatch by Subdomain
- **[Lazily Loading Views¶ and more](references/patterns-2.md)** (~7,949 tokens)
  - Topics: Converting to Centralized URL Map, Loading Late, Configuration

### Tutorial

- **[Blog Blueprint¶ and more](references/tutorial-1.md)** (~7,831 tokens)
  - Topics: The Blueprint, Index, Create
- **[Test Coverage¶ and more](references/tutorial-2.md)** (~4,538 tokens)
  - Topics: Setup and Fixtures, Factory, Database

## Usage Guidelines

1. **Identify relevant sections** - Match the user's question to the appropriate reference file(s)
2. **Load minimally** - Only read files directly relevant to the question to conserve context
3. **Cite sources** - Reference specific sections when answering
4. **Combine knowledge** - For complex questions, you may need multiple reference files

### When to use each reference:

- **General**: General documentation, overview, and getting started
- **Patterns**: Patterns-related features and documentation
- **Tutorial**: Tutorial-related features and documentation

Overview

This skill provides searchable, structured documentation extracted from the official Flask docs. It focuses on application patterns and the tutorial material, making it fast to find guidance for common Flask workflows and design decisions. Use it when you need authoritative, example-driven answers about building and structuring Flask apps.

How this skill works

The skill inspects relevant portions of the scraped Flask documentation—general API reference, pattern guides, and tutorial content—and returns concise, context-aware guidance. It maps user questions to the smallest set of reference sections (Application API, request/context handling, patterns, or tutorial blueprints) and synthesizes actionable steps, configuration options, and example snippets. When appropriate, it points to the specific doc areas used to form the response.

When to use it

  • Designing application structure, blueprints, and dispatching patterns
  • Implementing request and application contexts or session handling
  • Following tutorial steps for building a sample app (blog blueprint, tests, fixtures)
  • Learning recommended patterns for lazy loading views and app factories
  • Troubleshooting deployment and debugging best practices

Best practices

  • Match your question to one of the three primary areas: General, Patterns, or Tutorial to get focused answers
  • Prefer the documented app factory and blueprint patterns for scalable apps
  • Use context managers or explicit push for manual request/application context manipulation when needed
  • Follow documented testing patterns: factories, fixtures, and isolated app contexts for reliable tests
  • Check the API reference for configuration keys and the pattern docs for architectural choices

Example use cases

  • How to structure a blog app with blueprints and factories using the tutorial walkthrough
  • How to manually push an application or request context for background tasks
  • Patterns for dispatching requests across subdomains or combining multiple Flask apps
  • How to return JSON from a view and what helpers Flask provides
  • Best practices for debugging and configuring the development server

FAQ

Does this skill cover the full Flask API?

It draws from the official docs and focuses on the API, pattern guides, and tutorial materials; use the General/API sections for comprehensive reference.

Which source should I pick for architecture vs examples?

Use Patterns for architecture and dispatching patterns, and the Tutorial for step-by-step examples and concrete app code.