frontend-api-demos

Document frontend calls to think-tars demos API endpoints using standard browser fetch.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/freddomingues/think-tars --skill frontend-api-demos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontend-api-demos
Source: https://github.com/freddomingues/think-tars/tree/main/.cursor/skills/frontend-api-demos
Command: npx skills add https://github.com/freddomingues/think-tars --skill frontend-api-demos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps frontend developers understand and integrate the think-tars demos API by documenting how to call the demos service from the frontend, including how to fetch assistants, start conversations, upload PDFs, and send messages.

Core Features & Use Cases

  • Discover and enumerate available demo assistants from /api/demos/assistants.
  • Create conversations for selected assistants via /api/demos/conversations with optional agent_id.
  • Upload PDFs to initiate a conversation via /api/demos/upload-pdf and attach the content to a conversation.
  • Send messages to ongoing conversations using /api/demos/conversations/:id/messages.
  • Handle errors and loading states in the frontend according to the documented API.

Quick Start

Open the frontend app and use the demos API to list assistants, start a new conversation with a chosen agent, upload a PDF to attach to that conversation, and send messages to continue the dialogue.

Frequently Asked Questions about frontend-api-demos

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

FAQPage Schema
How do I call the think-tars demos API to fetch available assistants from the frontend?

To create a conversation, send a fetch request to the /api/demos/conversations endpoint, optionally including an agent_id. This initiates a new dialogue session for the chosen assistant, enabling subsequent message sending within your UI.

Can I upload a PDF to start a conversation using the frontend fetch API?

Yes, you can upload a PDF by sending a fetch request to the /api/demos/upload-pdf endpoint. This uploads the file and attaches its content to a conversation, allowing the assistant to process the document within the demos service.

How do I send messages to an ongoing conversation through the demos API?

To send messages to an ongoing conversation, use the fetch API to target the /api/demos/conversations/:id/messages endpoint. This continues the dialogue by transmitting user input to the specific session identified by its ID.

Do I need any external dependencies to integrate the think-tars demos API into my UI?

No external dependencies are required to integrate the demos API. The solution relies solely on standard browser fetch capabilities, allowing frontend developers to test API interactions and handle loading states without installing additional libraries.

What is the best way to handle errors and loading states when calling the demos API?

The best way to handle errors and loading states is to manage them according to the documented API responses. Use standard fetch error handling in your frontend to gracefully manage request failures and UI loading transitions during API interactions.