best-practices-arangodb

Installation
SKILL.md

STOP. READ THIS ENTIRE SKILL.MD BEFORE CALLING ANY ENDPOINT.

ArangoDB Best Practices (Project Skill)

This skill codifies rules for using ArangoDB correctly in this repo. The core principle:

ArangoDB's built-in features MUST be used instead of reimplementing them in Python.

The Anti-Pattern This Skill Prevents

Python code that duplicates what ArangoDB already does:

  • Stop word lists in Python (ArangoDB text_en already strips them)
  • Hand-rolled stemming in Python (ArangoDB text_en already stems via Snowball)
  • Regex patterns that classify entity types (ArangoDB collections already know what things are)
  • Hardcoded domain term lists (ArangoDB collections are the source of truth)
  • Python-side BM25/TF-IDF scoring (ArangoDB BM25() does this server-side)
  • Python-side cosine similarity loops (ArangoDB COSINE_SIMILARITY() does this server-side)

See references/anti-patterns-duplicated-functionality.md for 7 real removed-from-codebase examples.

Installs
2
GitHub Stars
7
First Seen
Mar 17, 2026
best-practices-arangodb — grahama1970/agent-skills