generated: '2026-08-13'
method: generated
source: openapi/ (five OpenAPI documents) + docs.lucidya.com introduction articles
name: Lucidya Agent Skills
type: AgentSkill
summary: >-
  Packaged Agent Skills for the marquee flows across Lucidya's five public REST
  APIs. Every operation named in these skills is a real operationId (or, where
  Lucidya's spec omits one, a real path) read out of the OpenAPI documents in
  openapi/. Nothing is invented: parameters, required flags, status codes, error
  envelopes and limits are all quoted from the provider's own contract or docs.
skill_count: 5
skills:
  - name: lucidya-pull-social-listening-widget-data
    file: lucidya-ltd-pull-social-listening-widget-data.md
    api: Lucidya Social Listening API
    spec: ../openapi/lucidya-ltd-social-listening-api-openapi.yml
    operations: 8
    summary: >-
      Monitor discovery to widget data across X, Facebook, Instagram and
      news/blogs, with pagination and the 403-on-repeated-errors trap.
  - name: lucidya-analyze-arabic-text
    file: lucidya-ltd-analyze-arabic-text.md
    api: Lucidya AI API
    spec: ../openapi/lucidya-ltd-ai-api-openapi.yml
    operations: 4
    summary: >-
      Batch sentiment, Arabic dialect/sub-dialect, domain and theme
      classification, paced for the AI API's 6 requests/minute and 100-text batch
      ceiling.
  - name: lucidya-transcribe-audio
    file: lucidya-ltd-transcribe-audio.md
    api: Lucidya AI API
    spec: ../openapi/lucidya-ltd-ai-api-openapi.yml
    operations: 3
    summary: >-
      Create-then-poll audio transcription with speaker diarization, per-speaker
      dialect and themes, and the 100-audio-minutes-per-minute duration quota.
  - name: lucidya-manage-cdp-profiles-and-segments
    file: lucidya-ltd-manage-cdp-profiles-and-segments.md
    api: Lucidya CDP API
    spec: ../openapi/lucidya-ltd-cdp-api-openapi.yml
    operations: 11
    summary: >-
      The platform's only real write surface — profiles, interactions, surveys and
      segment membership — including the missing DELETE on Profile.
  - name: lucidya-run-omniserve-analytics-job
    file: lucidya-ltd-run-omniserve-analytics-job.md
    api: Lucidya OmniServe Analytics API
    spec: ../openapi/lucidya-ltd-omniserve-analytics-api-openapi.yml
    operations: 15
    summary: >-
      Analytics page discovery, job creation and polling, CSAT analytics and
      reference lookups, on the one API served from a sub-path base URL.
provider_published_skills:
  present: false
  checked:
    - https://lucidya.com/llms.txt (404)
    - https://docs.lucidya.com/llms.txt (404)
    - https://github.com/lucidya (200, zero public repositories)
  note: >-
    Lucidya publishes no AGENTS.md, no skills directory and no llms.txt. These
    skills are generated by API Evangelist from the provider's published contract,
    not harvested from the provider.
shared_rules:
  auth: >-
    `luc-authorization: <token>` header on every call. Keys are bound to a single
    API product type — a Social Listening key will not open the AI API.
  idempotency: >-
    None exists anywhere in the surface. Every retried POST is a new request.
  rate_limits: >-
    100 requests/minute floor on four products, 6/minute on the AI API. Fixed
    window, resets on the minute. No RateLimit-* or Retry-After header is
    returned, so a client must self-pace.
  async: >-
    202 means "still running" on the OmniServe, OmniChannel and AI audio
    endpoints. Never treat any 2xx as final without checking the code.
  errors: >-
    Three envelope shapes are in production. See
    ../errors/lucidya-ltd-problem-types.yml.
cross_links:
  authentication: ../authentication/lucidya-ltd-authentication.yml
  conventions: ../conventions/lucidya-ltd-conventions.yml
  errors: ../errors/lucidya-ltd-problem-types.yml
  rate_limits: ../rate-limits/lucidya-ltd-rate-limits.yml
  data_model: ../data-model/lucidya-ltd-data-model.yml