Api Patterns

What it does

This skill enables AI agents to make API calls using Connect Query and properly handle responses within workflows. It provides hooks for fetching data, invalidating caches after mutations, and displaying error notifications (using formatToastErrorMessage). The skill also includes generated protobuf files for defining data structures, which should not be edited directly.

When to use it

• When your agent needs to retrieve data from an API endpoint.
• After a mutation (data update), when you need to invalidate cached data.
• To gracefully handle and display errors that occur during API calls.
• When working with protobuf definitions for structured data.

Key capabilities

• Connect Query hooks for fetching data.
• Cache invalidation after mutations.
• Error handling with toast notifications (using formatToastErrorMessage).
• Protobuf file generation and management (with a rule to regenerate: task proto:generate).

Example prompts

• "Fetch the latest data using the Connect Query hook."
• "Invalidate the cache after this mutation is complete."
• "Display an error notification if the API call fails."

Tips & gotchas

• The generated protobuf files in /src/protogen/ should not be edited directly. Use the task proto:generate rule to regenerate them.
• Refer to the rules located in the /rules/ directory for detailed guidance on queries, mutations, cache invalidation and error handling.
• This skill focuses specifically on API call management using Connect Query; it does not cover all aspects of data processing or general development tasks.