holistics/anfra-skills

anfra-aql

Core AQL (Analytic Query Language) knowledge — syntax, semantics, functions, worked examples, and gotchas.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/holistics/anfra-skills --skill anfra-aql

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

AQL core knowledge

AQL is Analytic Querying Language for data analytics. This skill is the knowledge base you consult while authoring AQL. It doesn't run queries — pair it with actionable skills such as [](../anfra-write-aql/), [](../anfra-validate-aql/), etc.

How to use these references

AQL is not SQL — don't write it from general or SQL knowledge. Read the core lessons before writing your first AQL; then pull in the specific per-function docs and examples your task needs (that part is on-demand — you needn't read everything).

  1. `references/aqlearn.md` — read this first, before writing any AQL. The single, complete AQL lessons + rules + glossary reference (aggregation, dimensions/measures, level of detail, nested aggregation, window functions, ranking, relationships, SQL passthrough, …). Don't skip it — it holds the vital details you won't find by guessing, and reading it up front is faster than writing wrong AQL and fixing it.
  2. `references/aql/` — per-function reference docs. Look up the exact

syntax, semantics, and argument order for a specific function or operator. Files are named by function/operator (e.g. sum.md, rank.md, where.md); browse the folder and open the one you need. Use this to double-check — never assume a function, argument, or argument order.

  1. `references/examples/` — worked examples. Follow proven patterns and

avoid known pitfalls.

  • Index — references/examples/INDEX.md is a table with columns

id | kind | analytic | problems | techniques | gotchas (kind is good or bad; the last three are tag slugs). To find examples, grep the index (or the example frontmatter) for a tag slug, or scan the analytic column; then open the matching references/examples/<id>.md.

  • Example file — references/examples/<id>.md has YAML frontmatter

(id, kind, analytic, problems, techniques, gotchas) followed by ## Dataset fields (``yaml), ## AQL (``aql), and learning points.

  • Tag glossaries (same folder) define the slugs: PROBLEMS.md (how to

frame the problem), TECHNIQUES.md (AQL idioms), GOTCHAS.md (pitfalls; entries marked [silent] fail with no validation error — a wrong-but-valid result — so look these up proactively).

  1. The AQL docs, for what these references don't cover: look it up with

[](../anfra-docs/).


anfra skills 0.21.0

del mismo repositorio

Más Skills

Todos los Skills