openapi-chromadb

Update the Dart chromadb package from ChromaDB OpenAPI spec changes.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill openapi-chromadb-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openapi-chromadb
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/ai_clients_dart/packages/chromadb/.agents/skills/openapi-chromadb
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill openapi-chromadb-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keeping a Dart client package in sync with an evolving ChromaDB OpenAPI specification requires manual diffing, model scaffolding, and verification. This Skill automates the fetch-review-scaffold-verify cycle so spec changes are reflected in the package consistently. ## Core Features & Use Cases - Spec Fetch & Review: Downloads the latest ChromaDB OpenAPI spec and reviews changes against the current package implementation. - Scaffolding & Verification: Generates Dart model scaffolds from schemas and runs verification checks across coverage, exports, and type mappings. - Use Case: When ChromaDB releases a new API version, run the workflow to fetch the updated spec, review drift, scaffold new models like collections or records, and verify the package before committing. ## Quick Start Use the openapi-chromadb skill to fetch the latest ChromaDB spec, review the changes, and verify the package.

Frequently Asked Questions about openapi-chromadb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a Dart package from OpenAPI spec changes?

Run the api-toolkit fetch command with the skill's config directory to download the latest spec, then use review to inspect changes, scaffold to generate Dart models, and verify to validate coverage and type mappings before promoting the spec.

How to scaffold Dart models from an OpenAPI schema?

Use the api-toolkit scaffold command with --target schema and --name flags against the skill's config directory. The manifest.json type mappings convert OpenAPI types like string, integer, and array into Dart String, int, and List types.

Does the ChromaDB OpenAPI workflow require authentication?

No authentication is required. The ChromaDB spec at api.trychroma.com/openapi.json is fetched remotely without auth environment variables, as declared in the specs.json configuration.

Why does type verification report mismatches on response models?

The verifier does not propagate item-level nullability or HashMap aliases into expected types, causing spurious mismatches on fields like documents and metadatas. These are documented as excluded_properties in the manifest with explanatory notes.

What quality checks run after implementing spec changes?

Run dart analyze --fatal-infos, dart format --set-exit-if-changed, and dart test test/unit/ from the package root, plus the api-toolkit verify command with --checks all --scope all for spec coverage validation.