Skip to content
Skills Library
Data & analytics · Building & coding

develop-amql

/develop-amql

Write and edit AML/AQL code for Holistics models, datasets, dashboards, and metrics. Use this whenever the user wants to create or modify a model, dataset, dashboard page, AQL metric, or any file in an AMQL project.

Repository
skills ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Write and edit AML/AQL code for Holistics models, datasets, dashboards, and metrics. Use this whenever the user wants to create or modify a model, dataset, dashboard page, AQL metric, or any file in an AMQL project.

Original author description

Write and edit AML/AQL code for Holistics models, datasets, dashboards, and metrics. Use this whenever the user wants to create or modify a model, dataset, dashboard page, AQL metric, or any file in an AMQL project.

How it works

  1. Instructions
  2. Example workflow
  3. Creating new datasets
  4. Working with Model files
  5. Working with Dashboard (page.aml) files
  6. References
  7. Related skills
Original SKILL.md headings · 39 lines, 306 words
SKILL.md preview
---
name: develop-amql
description: Write and edit AML/AQL code for Holistics models, datasets, dashboards, and metrics. Use this whenever the user wants to create or modify a model, dataset, dashboard page, AQL metric, or any file in an AMQL project.
---

## Instructions
* Use [](../setup-amql-development/) skill to prepare for the development
* **NEVER** assume any AML/AQL syntax, functions, or references.
* Use Holistics knowledge and tools
  * Refer to [](../../references/) and use `search_docs` to learn about code syntax. See [](../search-docs/) for invocation details.
  * Use `fetch_dataset` to learn about the dataset (e.g. all available models and fields within that dataset), in order to make accurate edits.
  * Use [](../write-aql/) to write AQL (e.g. AQL metrics); validate it with `validate_aql`.
  * Use `generate_viz` to define Viz.
  * Use `list_data_sources`, `list_data_source_schemas`, `read_data_source_schema`, `read_data_source_table_schema` to study the underlying database schema in order to write relevant and accurate modeling codes.
* Pay attention to code diagnostics and fix them if possible.

## Example workflow
1. Read relevant codes
2. If working with a dataset, use `fetch_dataset` to view all semantics of the dataset
3. Refer to [](../../references/) and use `search_docs` to learn the correct syntax
4. To write AQL, use [](../write-aql/); to define Viz, use `generate_viz`. For others, research further and write the codes.
5. Make code suggestions for the user

## Creating new datasets
* Make sure to properly create the models first before creating the dataset
* Remember to define relationships

## Working with Model files
* You currently are not able to query Models directly. Instead, look for the Dataset containing that Model and query that Dataset instead.
* Always try to write field definitions in AQL first. Only fall back to writing SQL definitions if AQL is not possible.

## Working with Dashboard (page.aml) files
* Remember to arrange your newly created blocks nicely and trim unnecessary spaces

## References
* See [](../../references/holistics.md) to learn about Holistics and AMQL.
* See [](../../references/data_modeling.md) to learn about Data modeling in Holistics.
* See [](../../references/aml.md) to learn about Holistics AML.

## Related skills
* [](../search-docs/)
* [](../write-aql/)
* [](../visualize-data/)

Versions

The database has no other skills named develop-amql.

Database snapshot: 13.11.2026 · package version ac8cbce9d851 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100holistics-migrate-power-bi
    Migrate a Power BI semantic model (TMDL + DAX) and reports to Holistics AMQL assets (AML models, datasets, dashboards, AQL/SQL metrics). Use this when converting a .pbix/.pbip project, translating DAX measures, mapping TMDL tables and relationships to Holistics models, or…
  • 100setup-amql-development
    Use this whenever working in a (Holistics) AMQL project (i.e. with AML files). It guides you to set up and review the AMQL development environment and tooling so that the development can be done accurately and efficiently. Tooling includes CLI, MCP, code synchronization, etc.
  • 100arangodb-multi-model-database-operations
    Covers operating ArangoDB, a multi-model database combining document, graph, and key-value collections in a single engine with a unified query language (AQL): collection type selection, graph traversal via AQL, and cluster configuration (coordinators, DB-servers, agency). Use…
  • 95develop-data-analysis-dashboard
    Data analysis dashboard (instrument panel) development skill. Use when users need to develop data dashboards, create/edit Dashboard projects, build large-screen data boards, or perform dashboard data cleaning. Includes dashboard project creation, card plan, data cleaning…
  • 100arangodb
    Expert ArangoDB multi-model database assistance covering AQL, document collections, graphs, and Foxx microservices. Use when querying graph relationships, joining document stores, or designing multi-model schemas.
  • 90semantic-layer-and-metric-governance
    Guides agents through semantic layer and shared metric design. Use when defining business metrics, reusable dimensions, governed metric contracts, or shared semantic models consumed by dashboards, analytics tools, or other teams.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.