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_enalready strips them) - Hand-rolled stemming in Python (ArangoDB
text_enalready 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.