SKILL.md — BSP Diagnostic Skills Registry

Overview

This directory contains pure Python Diagnostic Skills (Tools) for the Android BSP Consultant Agent. Each Skill is a deterministic, human-authored function that parses hardware/kernel logs and returns a structured diagnostic report.

Related documentation:

• docs/emulator-spec.md — exact software/source versions for all training emulators
• docs/skill-extension-guide.md — how end-user agents extend skills for real hardware

Architecture

Skills follow the Anthropic Tool-Use paradigm:

• Pure functions — no side effects, no LLM calls, no global state.
• Pydantic schemas — strict typed inputs/outputs for every Tool.
• Isolated testing — each Skill has a corresponding pytest test that does NOT invoke the LLM.

Expected Tool Structure

from pydantic import BaseModel

class MySkillInput(BaseModel):
    dmesg_log: str
    meminfo_log: str

class MySkillOutput(BaseModel):
    root_cause: str
    recommended_action: str
    confidence: float

def my_bsp_skill(input: MySkillInput) -> MySkillOutput:
    """
    Deterministic diagnostic function.
    Parse logs, extract metrics, return structured RCA.
    """
    ...

Current Skills

19 core skills across 5 supervisor routes. Phase 8 adds 4 workspace analysis skills (23 total including improvement tools). See reports/skill_validation_report.md for the full validation run.

Pattern coverage notes (real-hardware validated)

Domains

• bsp_diagnostics/ — Android BSP kernel/hardware log analysis.

Contributing

1. Write the pure Python function with strict Pydantic I/O.
2. Add a pytest test in tests/product_tests/ that exercises the function with fixture data.
3. Register the function as an Anthropic-compatible Tool in the Agent's tool registry.

See AGENTS.md §2.2 for the full Skill Registry contract.

Extending Skills for Real Hardware

The built-in patterns are trained on emulator logs (see docs/emulator-spec.md). When a skill misses a real-hardware pattern, use the two improvement skills:

1. validate_skill_extension — dry-run test of a proposed regex
2. suggest_pattern_improvement — write the validated pattern to ~/.bsp-diagnostics/skill_extensions.json

See docs/skill-extension-guide.md for the full workflow and examples.