Conviu Skills

https://github.com/conviu/conviu-skills
Admin
Conviu Skills provides shared AI skills and documentation for working with Conviu product data...
Tokens:6,673
Snippets:103
Trust Score:7.5
License:MIT
Update:3 months ago
Show doc for...
Tokens:
Raw
### FQL Filter Examples

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md

Various examples demonstrating range queries, negation, regex matching, and specific field constraints.

```text
(brand:"Nike" OR brand:"Adidas") AND (salePrice:["100" TO "500"]) AND (inStock:"true")
```

```text
(salePrice:{"1000" TO *]) AND (inStock:"true")
```

```text
(salePrice:{"100" TO "500"}) AND (brand:"Nike"#s)
```

```text
(dataSource.uid:"<uid32>") AND (approval:"pending")
```

```text
(title:"*sleva*") AND (NOT title:"*výprodej*")
```

```text
title:{"70" TO *]#L
```

```text
sku:"~^AB[0-9]{4}$~"#s
```

```text
id:("101;102;103")
```

--------------------------------

### Initialize Conviu Skills via CLI

Source: https://github.com/conviu/conviu-skills/blob/main/README.md

Use these commands to install skills into supported AI tools or list available integrations.

```bash
npx conviu-agent init --ai cursor      # one tool
npx conviu-agent init --all            # every supported tool
npx conviu-agent list                  # list supported tools
```

--------------------------------

### Install Conviu Agent via Claude Code

Source: https://github.com/conviu/conviu-skills/blob/main/README.md

Commands to add the marketplace and install the conviu-agent plugin within the Claude Code environment.

```text
/plugin marketplace add conviu/conviu-skills
/plugin install conviu-agent@conviu-skills
```

--------------------------------

### Conviu Agent CLI Commands

Source: https://github.com/conviu/conviu-skills/blob/main/cli/README.md

Use these commands to manage the installation of the Conviu Agent skill across supported AI coding tools.

```bash
npx conviu-agent init --ai cursor      # install for one tool
npx conviu-agent init --all            # install for every supported tool
npx conviu-agent uninstall --ai cursor # remove from one tool (or --all)
npx conviu-agent list                  # list supported tools
```

--------------------------------

### Repository Directory Structure

Source: https://github.com/conviu/conviu-skills/blob/main/README.md

Visual representation of the project file hierarchy and configuration locations.

```text
conviu-skills/
├── .claude-plugin/
│   └── marketplace.json          # marketplace manifest (list of plugins)
├── plugins/
│   └── conviu-agent/
│       ├── .claude-plugin/
│       │   └── plugin.json        # plugin manifest
│       └── skills/
│           └── conviu-agent/
│               ├── SKILL.md       # skill entry point
│               └── references/    # detailed playbooks and reference material
├── cli/                          # npx installer for other AI tools
│   ├── index.mjs
│   └── platforms.json            # per-tool target paths
├── package.json                  # npm package (bin: conviu-agent)
├── skill.json                    # skill metadata + supported platforms
├── context7.json                 # Context7 indexing configuration
├── README.md
└── LICENSE
```

--------------------------------

### Conviu Product Data Flow Diagram

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/SKILL.md

Visual representation of the data lifecycle from e-shop import to platform export.

```text
E-SHOP / SUPPLIER  ──▶  IMPORT  ──▶  products in Conviu  ──▶  EXPORT  ──▶  Platform / channel
  feed URL, FTP,      data source       items (products         data          Zboží, Heureka,
  Sheet, API, upload                     or orders)           writer job     Google, Glami, FTP…
```

--------------------------------

### Sorting Configuration

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md

Define sorting order using field and order keys within an object.

```json
{ "field": "lastImportedAt", "order": "DESC" }
```

--------------------------------

### FQL Set Syntax

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md

Use the #s suffix inside parentheses to define a set of values.

```fql
field:("a;b"#s)
```

--------------------------------

### Canonical FQL Query Structure

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md

The standard format for complex filters, grouping OR-alternatives in parentheses and joining them with AND.

```text
(brand:"Nike" OR brand:"Adidas") AND (salePrice:["100" TO "500"]) AND (inStock:"true")
```

--------------------------------

### FQL Value Syntax

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/fql.md

Use the #s suffix after the closing quote for single values.

```fql
field:"value"#s
```

--------------------------------

### Conviu Agent API Navigation Flow

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/SKILL.md

The recommended sequence of API calls to explore organization data, modules, and job statuses.

```text
whoami → get_organization / list_organizations → get_organization_modules  (status of every module)
                                                → list_data_sources        (imports)
                                                → list_data_writer_jobs    (exports)
                                                → list_data_queries        (sources)
                                                    → get_* detail on the specific item
```

--------------------------------

### get_data_writer_job_latest_download_logs

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md

Retrieves recent download activity logs for a data writer job.

```APIDOC
## get_data_writer_job_latest_download_logs

### Description
Fetches recent download activity to determine who has accessed the feed.

### Parameters
- **dataWriterJobUid** (string) - Required - The unique identifier of the data writer job.
```

--------------------------------

### get_data_writer_job_validation

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md

Retrieves detailed information about a specific validation run using its unique identifier.

```APIDOC
## get_data_writer_job_validation

### Description
Provides detailed information about a specific validation run, including the feed URL and any failure reasons if the run itself failed.

### Parameters
- **uid** (string) - Required - The unique identifier of the validation (obtained from get_data_writer_job_latest_validation).

### Response
- **feedUrl** (string) - The URL of the feed that was checked.
- **failureReason** (string) - The reason for a validation run failure.
- **failureMessage** (string) - A descriptive message regarding the validation run failure.
```

--------------------------------

### trigger_data_writer_job_validation

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md

Triggers a fresh validation run for a specific data writer job.

```APIDOC
## trigger_data_writer_job_validation

### Description
Initiates a new validation process for the specified export. This is a write operation that consumes resources.

### Parameters
- **uid** (string) - Required - The unique identifier of the export (data writer job).
```

--------------------------------

### get_data_writer_job_latest_validation

Source: https://github.com/conviu/conviu-skills/blob/main/plugins/conviu-agent/skills/conviu-agent/references/validation.md

Retrieves the latest validation status and counts for a specific data writer job.

```APIDOC
## get_data_writer_job_latest_validation

### Description
Retrieves the most recent validation results for a data writer job, including error, warning, and info counts.

### Parameters
- **dataWriterJobUid** (string) - Required - The unique identifier of the data writer job.

### Response
- **uid** (string) - The unique identifier of the validation.
- **validationId** (string) - The ID of the validation run.
- **state** (string) - The current state of the validation.
- **createdAt** (string) - Timestamp of creation.
- **completedAt** (string) - Timestamp of completion.
- **errorCount** (integer) - Number of errors found.
- **warningCount** (integer) - Number of warnings found.
- **infoCount** (integer) - Number of info messages found.
```
Tokens:
Raw