name: Bluetooth Core Specification description: Instructions for reading the Bluetooth Core Specification.

Bluetooth Core Specification Management

This resource explains how to access, search, and cite the Bluetooth Core Specification effectively using the dedicated local cache and management tools.

The Local Cache Strategy

Since the official Bluetooth specification is massive and fragmented, we use a local cache of the seven most critical “Core” chapters. This allows for instant, reliable searching even for complex data like packet formats and section numbers.

The Three-File System

For every chapter in the core specification, the shared cache contains three versions:

  1. <name>.md (The Search Index): Our primary search target. It features Markdown tables and stitched headers (e.g., “3.5.1. Pairing Request”) on single lines for perfect grep_search results.
  2. <name>_pretty.html (The Context View): A formatted HTML file used for view_file. Use this to see original tables, lists, and diagram references once you've found the correct section in the .md file.
  3. <name>.html (The Source): The raw, minified official HTML from bluetooth.com.

Section Index

We maintain a global index.md in the specifications directory.

  • Use this first: To find which file contains a specific section number or topic, run grep_search on index.md. The index.md output will contain the file name and the exact line number (e.g., logical-link-control-and-adaptation-protocol-specification.md:1057), allowing you to use view_file to jump directly to the correct line in the corresponding .md file.

Management Tooling

Synchronizing the Cache

To refresh all core specifications or initialize the cache, run the downloader directly with Python: python3 .agents/skills/core_specification/scripts/downloader.py

Note: The generated Markdown files, HTML copies, and global index.md will be placed in the source folder at: .agents/skills/core_specification/specifications/

This tool automatically:

  • Downloads the latest HTML from official URLs.
  • Converts HTML tables into readable Markdown tables.
  • Stitches fragmented section numbers into searchable headers.
  • Re-generates the index.md.

How to Research and Search

  1. Start with the Core Specs:
    • Use grep_search on .agents/skills/core_specification/specifications/index.md to find the correct file and line number.
    • Use Case Insensitivity: The Bluetooth specification uses inconsistent capitalization. Always use CaseInsensitive: true when searching.
    • Once you have the target file name and line number from index.md, use view_file to read the exact section in the corresponding .md file.
  2. When the topic is outside the Core Specs:
    • Use the search_web tool with site:bluetooth.com/wp-content/uploads/Files/Specification/HTML/Core-62 "term".
  3. Citing the Specification:
    • Always provide the Volume, Part, and Section (e.g., “Vol 3, Part H, Section 3.5.1”).