Skills Guide

API Quicks Workspace

VérifiéSûr

Interagir avec l'espace de travail Quicks via l'API JSON externe. Lire, écrire des pages et des cartes.

Spar Skills Guide Bot
ProductiviteIntermédiaire
0024/07/2026
Claude Code
#quicks#workspace-api#notes#cards#json-api

Recommandé pour

Claude CodeProduct managerDébutantProductivitéSolo / indie hacker

Notre avis

Permet de lire et écrire des pages et cartes dans un espace de travail Quicks via son API JSON externe, en utilisant un token d'authentification intégré dans l'URL.

Points forts

  • Authentification simple : token directement dans l'URL, pas d'en-têtes supplémentaires.
  • Gestion complète des pages et des cartes (CRUD) avec support des notes Markdown.
  • Détection et sauvegarde automatique de l'URL de base pour une utilisation répétée.

Limites

  • Nécessite une connexion Internet et un accès à l'API Quicks.
  • Dépend du format spécifique des URL Quicks (/api/x/), non générique.
  • Les chemins peuvent contenir des caractères non ASCII, ce qui peut poser des problèmes d'encodage.
Quand l'utiliser

Utilisez cette compétence lorsque vous devez interagir avec un espace de travail Quicks, par exemple pour synchroniser des notes, automatiser la création de fiches ou intégrer des données externes.

Quand l'éviter

Évitez de l'utiliser si vous travaillez avec d'autres plateformes de gestion de contenu ou si vous avez besoin d'une API REST standard nécessitant des headers d'authentification complexes.

Analyse de sécurité

Sûr
Score qualité90/100

The skill only describes an HTTP API via WebFetch; no destructive commands, exfiltration, or obfuscation are present. The use of an embedded token in the URL is a standard API pattern, and the skill does not instruct the agent to expose it to third parties.

Aucun point d'attention détecté

Exemples

Create a new page
Create a new page called 'Meeting Notes' under the parent page 'Work' in my Quicks workspace.
Add a notes card to a page
Add a notes card to the page 'Project Alpha' with the text '# Status Update
- Completed task A
- Started task B'.
List all pages
Show me all pages in my Quicks workspace.

name: quicks-api description: > Interact with Quicks workspace via the external JSON API. Use when the user provides a quicks.ai URL (contains /api/x/), asks to read/write workspace pages or cards, or wants to give an LLM access to their workspace data. allowed-tools: WebFetch

Quicks Workspace API

JSON API for reading and writing pages with cards. Auth token is embedded in the URL — no headers needed.

Token resolution

On every invocation, resolve the base URL in this order:

  1. User provided a URL (contains /api/x/) → extract base URL, save to ~/.quicks/token.json
  2. File ~/.quicks/token.json exists → read and use baseUrl from it
  3. Neither → ask the user to get their API URL at https://3.quicks.ai/account

Token file format (~/.quicks/token.json)

{ "baseUrl": "https://api-3.quicks.ai/api/x/abc123-..." }

Endpoints

All endpoints use {base} = the baseUrl from token. Paths may contain non-ASCII (Cyrillic). Use paths exactly as returned by GET {base}.

Pages

| Method | Path | Body | Response | |--------|------|------|----------| | GET | {base} | — | { widgets, pages } — list all pages and schemas | | GET | {base}/pages/{path} | — | { page, cards } — read page with all cards | | PUT | {base}/pages/{path} | { cards: [{ id, data }] } | { ok } — update cards | | POST | {base}/pages | { parentPath?, slug, name } | { path } — create page |

Cards

| Method | Path | Body | Response | |--------|------|------|----------| | POST | {base}/pages/{path}/cards | { type, name?, data? } | { id } (201) — create card | | DELETE | {base}/pages/{path}/cards/{cardId} | — | { ok } — delete card |

Notes (markdown shortcuts)

| Method | Path | Body | Response | |--------|------|------|----------| | POST | {base}/pages/{path}/notes | { name?, text } | { id } (201) — create notes card | | GET | {base}/pages/{path}/notes/{cardId} | — | { id, name, text } — read notes | | PUT | {base}/pages/{path}/notes/{cardId} | { text } | { ok } — update notes |

Tips

  • type: "text" = long markdown content, type: "string" = short value
  • Card status is read-only: "empty" | "processing" | "done" | "error"
  • Errors: 401 = bad token, 404 = page/card not found, 400 = validation error
  • Before adding content, read the page first to check for duplicates
Skills similaires

Priorisation de Tâches

Productivite

Priorise vos tâches avec les frameworks Eisenhower, ICE et RICE.

claudechatgptbeginner
241
67
726
Admin

Generateur de Rapport Hebdomadaire

Productivite

Generez des rapports de statut hebdomadaires structures et concis.

Claude CodeCursorWindsurf+1beginner
234
78
755
Admin

Rapport de Daily Standup

Productivite

Génère des rapports de daily standup structurés et concis.

claudeCursorWindsurfbeginner
178
45
594
Admin