Building blocks/Guidance

QuranTech

Experimental

Quran application knowledge and development guidance prepared for AI coding agents.

Quick startqurantech-skill
Package
quran-ws/qurantech-skill
Version
0.1.0
References
19 focused files
Format
Agent Skill

What it provides

  • A lean SKILL.md entry point with 19 reference files loaded only when the task needs them
  • Coverage of data sources, rendering, qiraat, audio, search, hifz, i'rab and adab
  • Technology-agnostic guidance — Flutter, Swift, Kotlin, React, Laravel or anything else

Use it when you need

Use it when working with an AI coding agent and you want it to understand riwayat, ayah counting, Quran data structures, project components, and conventions for Quran applications.

  • An AI agent is writing Quran application code
  • You want the domain traps encoded rather than rediscovered
  • You need adab rules for handling sacred text in software

Not for

  • Runtime behaviour — it ships no code into your app.
  • Verified text. That is Quran Text.

See it work

Several things this block does, each running on data from the repository itself.

What generic coding knowledge gets wrong about Quran apps.

Not running here

Building Quran apps has domain traps that generic coding knowledge walks straight into. These are the ones the skill puts in front of an agent before it writes anything.

Hard-coding 6,236 ayahs.
Counts differ across riwayat. Read it from the loaded riwayah.
Matching verses across mushafs by number.
They merge and split. Map references instead.
Rendering Uthmani script in a system font.
Glyphs break. Ship the edition's own font.
Unicode-normalising the text.
It destroys codepoints Unicode only added in 2021. Store it byte-exact.
Auto-generating tafsir with an LLM.
Dangerous. Scholarly content needs a named source.
Two rules run through all of it: never compromise the text — verified sources, byte-exact storage, integrity checks in CI — and don’t reinvent solved problems, which is why the skill points at existing datasets and packages before recommending a custom build.
Guidance, not runtime. It ships no code into your application.

Provenance

Every dataset identifies its source, edition, riwayah, version, and verification status. The digest lets you confirm the file you ship is the file that was verified.

View full provenance →
QuranTechExperimental
Repositoryquran-ws/qurantech-skill
Packagequran-ws/qurantech-skill
Version0.1.0
LicenceCC BY 4.0 (the content) · MIT (the tooling)
Publicyes

Quick start

The shortest path to something running. The repository’s README covers the rest.

$ /plugin marketplace add https://github.com/quran-ws/qurantech-skill
/plugin install qurantech@qurantech-skill
  // then: /qurantech:qurantech
Read the full documentation →

Works with

Blocks meet through shared references, not through a framework. Each of these understands something this block produces.

Quran TextThe source it points agents at first.Quran EngineGuidance on rendering choices.