Agent skill

Quran Lookup

Looks up Quran verses, chapters and juz in Arabic with English, Urdu and Hindi translations through a local Node.js and SQLite module.

CC-BY-4.0Auto-check: notesEducation

Install Quran Lookup

skills CLI

$ npx skills add qzaidi/quran --skill quran -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install qzaidi/quran quran --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/qzaidi/quran.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/quran .claude/skills/quran && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "quran" agent skill from https://github.com/qzaidi/quran/tree/master/.claude/skills/quran into .claude/skills/quran/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quran", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/qzaidi/quran/tree/master/.claude/skills/quran

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add qzaidi/quran --skill quran -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install qzaidi/quran quran --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/qzaidi/quran.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/quran .agents/skills/quran && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "quran" agent skill from https://github.com/qzaidi/quran/tree/master/.claude/skills/quran into .agents/skills/quran/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quran", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add qzaidi/quran --skill quran -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install qzaidi/quran quran --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/qzaidi/quran.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/quran .cursor/skills/quran && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "quran" agent skill from https://github.com/qzaidi/quran/tree/master/.claude/skills/quran into .cursor/skills/quran/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quran", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/qzaidi/quran.git --path .claude/skills/quran

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add qzaidi/quran --skill quran -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install qzaidi/quran quran --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/qzaidi/quran.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/quran .gemini/skills/quran && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "quran" agent skill from https://github.com/qzaidi/quran/tree/master/.claude/skills/quran into .gemini/skills/quran/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quran", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install qzaidi/quran quran

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add qzaidi/quran --skill quran -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/qzaidi/quran.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/quran .github/skills/quran && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "quran" agent skill from https://github.com/qzaidi/quran/tree/master/.claude/skills/quran into .github/skills/quran/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quran", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add qzaidi/quran --skill quran -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install qzaidi/quran quran --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/qzaidi/quran.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/quran .opencode/skills/quran && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "quran" agent skill from https://github.com/qzaidi/quran/tree/master/.claude/skills/quran into .opencode/skills/quran/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quran", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: quran
GitHub stars: 126
Token cost: ~1.1k tokens
SKILL.md length: 307 words
Files: 1
Skills in repo: 1
Repo updated: Apr 28, 2026
First seen: Oct 7, 2026
Licence: CC-BY-4.0

At a glance

Looks up Quran verses, chapters and juz in Arabic with English, Urdu and Hindi translations through a local Node.js and SQLite module.

Fetching a specific verse or range of verses with a translation
SKILL.md covers What It Does, Install, API Reference and Supported Languages, plus 3 more sections
Calls node and gh
Reading a full chapter in Arabic and English

What it does

This skill gives the agent a local interface to the Quran through a bundled npm module backed by SQLite. It can fetch Arabic text and translations in English, Urdu and Hindi, and query by chapter (surah), verse (ayah), juz or text search, covering single verses, ranges, arrays of verses and whole chapters.

The JavaScript API has get for Arabic text, select for filtered queries with offset, limit and language options, chapter for metadata on one chapter or all 114, juz for the boundaries of juz 1 to 30, and search for a text match in a chosen translation. The database ships Arabic in the Uthmani script, the Sahih International English translation, and Urdu and Hindi. The skill also explains how to link it into the Claude skills folder.

When your agent uses it

Fetching a specific verse or range of verses with a translation
Reading a full chapter in Arabic and English
Finding verses that mention a word in a chosen translation
Looking up chapter metadata or the start of a juz

Example prompts

“Show surah 2 verses 1 to 5 in Arabic with the English translation.”
“Search the English translation for verses that mention mercy.”
“Get the starting verse of juz 1 and the details of chapter 1.”
“Fetch chapter 1 in Urdu next to the Arabic.”

Requirements

Node.js with the local quran npm module and its SQLite database
Pre-approved tools (allowed-tools): Bash, Read

What it can do on your machine

Read from SKILL.md and the folder at commit 5ab4b13. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash
- Read
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- node
- gh
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Quran Lookup loads about 1.1k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 307 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~49
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Bash, Read
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from qzaidi/quran at commit 5ab4b13, republished under its CC-BY-4.0 licence (© qzaidi). 307 words, ~1,080 tokens.

Download SKILL.mdSave it as .claude/skills/quran/SKILL.md (or your agent's skills folder).

name: quran
description: Query the Holy Quran — fetch verses, chapters, juz, and translations. Use when the user asks about Quran verses, surahs, chapters, juz, Arabic text, or translations (English, Urdu, Hindi).
allowed-tools: Bash, Read

Quran Skill

Interface to the Holy Quran via the local quran npm module (Node.js + SQLite).

What It Does

Fetch Arabic text and translations (en, ur, hi)
Query by chapter (surah), verse (ayah), juz, or search text
Supports single verses, verse ranges, arrays of verses, and full chapters

Install

If this skill is not yet linked, run from the repo root:

bash

ln -s "$(pwd)/.claude/skills/quran" ~/.claude/skills/quran

Or install via the helper:

bash

gh install skill  # symlinks .claude/skills/quran → ~/.claude/skills/quran

API Reference

javascript

var quran = require('../../..');

The module root is three levels above this skill directory (../../..).

`quran.get(chapter, [verse], callback)`

Fetch Arabic text only. Callback receives (err, verses) where verses is an array of Arabic strings.

javascript

// Single verse
quran.get(2, 1, (err, v) => console.log(v[0]));
// → "الٓمٓ"

// Full chapter
quran.get(1, (err, verses) => console.log(verses.join('\n')));

`quran.select(filters, [options], callback)`

Advanced query. Callback receives (err, verses) where each verse is an object: { chapter, verse, ar, [lang...] }.

javascript

// Verses 2–4 of chapter 1 with English translation
quran.select({ chapter: 1 }, { offset: 1, limit: 3, language: 'en' }, (err, verses) => {
  verses.forEach(v => console.log(`${v.verse}: ${v.ar} — ${v.en}`));
});

// Specific verses by array
quran.select({ chapter: 1, verse: [2, 4, 6] }, (err, verses) => {
  console.log(verses);
});

Filters: { chapter, verse } — verse can be a number or array of numbers.

Options:

offset — skip N verses
limit — return N verses
language — translation code ('en', 'ur', 'hi') or array of codes
debug — print generated SQL

`quran.chapter([chapterNum], callback)`

Get chapter metadata. Without chapterNum, returns all 114 chapters.

javascript

quran.chapter(1, (err, info) => console.log(info));
// → [{ id: 1, name: 'Al-Faatiha', ... }]

`quran.juz([juzNum], callback)`

Get juz (para) boundaries. juzNum must be 1–30.

javascript

quran.juz(1, (err, juz) => console.log(juz));
// → [{ id: 1, chapter: 1, verse: 1, ... }]

`quran.search(lang, text, callback)`

Search translations for text (LIKE match).

javascript

quran.search('en', 'mercy', (err, results) => console.log(results));
// → [{ chapter: 1, verse: 1, en: 'In the name of Allah...' }, ...]

Supported Languages

The SQLite database ships with:

ar — Arabic (Uthmani script, default)
en — English (Sahih International)
ur — Urdu
hi — Hindi

To check available translation tables at runtime:

javascript

quran.safe(() => console.log(quran.langs));

Usage Patterns

Task	Method
Read a single verse	`quran.get(chapter, verse, cb)`
Read a full chapter	`quran.get(chapter, cb)`
Read with translation	`quran.select({chapter}, {language: 'en'}, cb)`
Read a range	`quran.select({chapter}, {offset: 0, limit: 5}, cb)`
Search a word	`quran.search('en', 'word', cb)`
Chapter info	`quran.chapter(num, cb)`
Juz boundaries	`quran.juz(num, cb)`

Running in Claude

All examples below run from the skill directory (.claude/skills/quran). The module is resolved via ../../.. (repo root).

bash

node -e "var q=require('../../..'); q.get(1,1,(e,v)=>console.log(v[0]))"

Or write temporary scripts to /tmp and run them.

Examples

User: "What is the first verse of Surah Al-Baqarah?"

bash

node -e "var q=require('../../..'); q.get(2,1,(e,v)=>console.log(v[0]))"

User: "Show me the English translation of Surah Fatiha"

bash

node -e "var q=require('../../..'); q.select({chapter:1},{language:'en'},(e,v)=>v.forEach(x=>console.log(x.verse+'. '+x.en)))"

User: "Search for verses about mercy"

bash

node -e "var q=require('../../..'); q.search('en','mercy',(e,r)=>r.slice(0,5).forEach(v=>console.log(v.chapter+':'+v.verse+' '+v.en)))"

Files

Just SKILL.md in .claude/skills/quran of qzaidi/quran.

Open the folder on GitHubat commit 5ab4b13

Compare with similar skills

Quran Lookup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Quran Lookup compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Quran Lookup this skillqzaidi/quran	126	—	~1.1k	Automated safety check: Notes	CC-BY-4.0	5 mo ago
Cortexdb Memory Openclawliliang-cn/cortexdb	274	—	~1.6k	Automated safety check: Pass	MIT	2 days ago
Bunbrianlovin/agent-config	377	1 repos	~484	Automated safety check: Notes	None	6 mo ago
Node ModernWrongStack/WrongStack	371	—	~1.9k	Automated safety check: Notes	MIT	yesterday
Knap Markdown Templateskepano/obsidian-skills	49k	2 repos	~986	Automated safety check: Pass	MIT	25 days ago
MCP Server BuildershareAI-lab/learn-claude-code	78k	4 repos	~1.2k	Automated safety check: Pass	MIT	12 days ago

Similar skills

Cortexdb Memory Openclaw
liliang-cn/cortexdb
Give a Node.js agent (such as OpenClaw) durable, local-first memory plus a queryable SPARQL knowledge graph, backed by CortexDB through its gRPC sidecar and the cortexdb-client npm package.
274 GitHub stars~1.6k tokensUpdated 2 days ago
Knowledge ManagementAuto-check passed
Bun
brianlovin/agent-config
Use Bun instead of Node.js, npm, pnpm, or vite. An agent skill from brianlovin/agent-config.
377 GitHub starsUsed in 1 repo~484 tokens
Frontend & DesignAuto-check: notes
Node Modern
WrongStack/WrongStack
A skill your agent uses when writing, reviewing, or refactoring Node.js code — modules, async flow, cancellation, file and process I/O, HTTP — on a current Node.js release.
371 GitHub stars~1.9k tokensUpdated yesterday
DevelopmentAuto-check: notes
Knap Markdown Templates
kepano/obsidian-skills
Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.
49k GitHub starsUsed in 2 repos~986 tokens
Documents & OfficeAuto-check passed
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
78k GitHub starsUsed in 4 repos~1.2k tokens
Agent WorkflowsAuto-check passed
Chrome CDP Browser Control
zenstory-ai/oh-story-claudecode
Drives a Chrome window over the DevTools Protocol with the agent-browser CLI, so the agent can reuse your logged-in sessions, read pages and pull tokens.
7.4k GitHub starsUsed in 2 repos~1.2k tokens
Productivity & AutomationAuto-check passed

Works with

Questions about Quran Lookup

What does Quran Lookup do?

Looks up Quran verses, chapters and juz in Arabic with English, Urdu and Hindi translations through a local Node.js and SQLite module. This skill gives the agent a local interface to the Quran through a bundled npm module backed by SQLite. It can fetch Arabic text and translations in English, Urdu and Hindi, and query by chapter (surah), verse (ayah), juz or text search, covering single verses, ranges, arrays of verses and whole chapters.

When should I use Quran Lookup?

Quran Lookup fits situations like: fetching a specific verse or range of verses with a translation; reading a full chapter in Arabic and English; finding verses that mention a word in a chosen translation; looking up chapter metadata or the start of a juz.

How do I install Quran Lookup in Claude Code?

Run `npx skills add qzaidi/quran --skill quran -a claude-code`. Or copy the skill folder (.claude/skills/quran in qzaidi/quran) into .claude/skills/quran in your project. Claude Code loads it when a task matches its description.

How do I install Quran Lookup in Codex?

Run `npx skills add qzaidi/quran --skill quran -a codex`. Or copy the skill folder (.claude/skills/quran in qzaidi/quran) into .agents/skills/quran in your project. Codex loads it when a task matches its description.

Can I use Quran Lookup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qzaidi/quran --skill quran -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quran, .gemini/skills/quran, .github/skills/quran and .opencode/skills/quran in your project.

What does Quran Lookup need to run?

Going by SKILL.md and its folder, Quran Lookup needs the command-line tools its instructions call (node and gh). Our summary lists: Node.js with the local quran npm module and its SQLite database. Its frontmatter pre-approves these tools: Bash, Read.

Does Quran Lookup access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Quran Lookup safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Quran Lookup use?

Quran Lookup is published under the CC-BY-4.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Quran Lookup use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Quran Lookup?

Skills that share tags, products or a category with Quran Lookup: Cortexdb Memory Openclaw (liliang-cn/cortexdb, 274 stars), Bun (brianlovin/agent-config, 377 stars), Node Modern (WrongStack/WrongStack, 371 stars) and Knap Markdown Templates (kepano/obsidian-skills, 49k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Quran Lookup?

qzaidi (a GitHub user) maintains it in qzaidi/quran, which has 126 GitHub stars. The repository was last updated on April 28, 2026.

Source: qzaidi/quran on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Quran Lookup

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Quran Skill

What It Does

Install

API Reference

quran.get(chapter, [verse], callback)

quran.select(filters, [options], callback)

quran.chapter([chapterNum], callback)

quran.juz([juzNum], callback)

quran.search(lang, text, callback)

Supported Languages

Usage Patterns

Running in Claude

Examples

Files

Compare with similar skills

Similar skills

Cortexdb Memory Openclaw

Bun

Node Modern

Knap Markdown Templates

MCP Server Builder

Chrome CDP Browser Control

Related

Questions about Quran Lookup

`quran.get(chapter, [verse], callback)`

`quran.select(filters, [options], callback)`

`quran.chapter([chapterNum], callback)`

`quran.juz([juzNum], callback)`

`quran.search(lang, text, callback)`