ramadan-cal 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,8 @@
 # 🌙 ramadan-cal
 
-A beautiful terminal Ramadan calendar with prayer times, daily progress, and Hijri date tracking.
+A beautiful terminal Ramadan 2026 (1447 Hijri) calendar with prayer times, Eid countdown, and daily progress — available as a CLI tool and inside Claude Code.
+
+[**Website**](https://ramadan-cal-site.onrender.com) · [**npm**](https://www.npmjs.com/package/ramadan-cal)
 
 ## Install
 
@@ -11,7 +13,7 @@ npm install -g ramadan-cal
 ## Usage
 
 ```bash
-ramadan              # Full display: prayer times + calendar
+ramadan              # Full display: prayer times + calendar + progress
 ramadan times        # Prayer times only
 ramadan calendar     # Calendar only
 ramadan check        # Check prayer times for any city
@@ -27,7 +29,7 @@ Prayer times are calculated offline using the [adhan](https://github.com/batoula
 
 ## Claude Code
 
-During installation you'll be asked if you want to set up Claude Code integration. If enabled, type `ramadan` inside any Claude Code session to see your calendar — zero tokens used.
+During installation, ramadan-cal automatically sets up a Claude Code skill. Just type `ramadan` inside any Claude Code session to see your Ramadan dashboard — prayer times, calendar, and Eid countdown — without leaving your coding flow. Zero tokens used.
 
 If you skipped during install, run `npm rebuild ramadan-cal` to set it up later.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ramadan-cal",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "🌙 A beautiful terminal Ramadan calendar with prayer times, daily progress, and Hijri date",
   "type": "module",
   "bin": {

package/scripts/postinstall.js

@@ -14,6 +14,9 @@ import { createInterface } from 'readline';
 const home = homedir();
 const claudeDir = join(home, '.claude');
 const claudeMd = join(claudeDir, 'CLAUDE.md');
+const skillsDir = join(claudeDir, 'skills');
+const ramadanSkillDir = join(skillsDir, 'ramadan');
+const ramadanSkillFile = join(ramadanSkillDir, 'SKILL.md');
 
 const MARKER = '<!-- ramadan-cal -->';
 const CLAUDE_ENTRY = `
@@ -23,6 +26,22 @@ When the user types "ramadan" or any command starting with "ramadan" (like "rama
 ${MARKER}
 `;
 
+const SKILL_MARKER = '<!-- ramadan-cal-skill -->';
+const RAMADAN_SKILL = `---
+name: ramadan
+description: Show Ramadan prayer times, Eid countdown, and Islamic calendar info. Use when the user invokes /ramadan with optional subcommands: times, calendar, eid YYYY-MM-DD, reset, check.
+disable-model-invocation: true
+---
+
+${SKILL_MARKER}
+
+Run the Ramadan CLI and display the output exactly as returned:
+
+\`\`\`bash
+ramadan $ARGUMENTS
+\`\`\`
+`;
+
 function isClaudeInstalled() {
   try {
     execSync('which claude', { stdio: 'ignore' });
@@ -32,12 +51,24 @@ function isClaudeInstalled() {
   }
 }
 
-function isAlreadyConfigured() {
+function isClaudeMdConfigured() {
   if (!existsSync(claudeMd)) return false;
   const content = readFileSync(claudeMd, 'utf-8');
   return content.includes(MARKER);
 }
 
+function isSkillInstalled() {
+  if (!existsSync(ramadanSkillFile)) return false;
+  const content = readFileSync(ramadanSkillFile, 'utf-8');
+  return content.includes(SKILL_MARKER);
+}
+
+function isConflictingSkill() {
+  if (!existsSync(ramadanSkillFile)) return false;
+  const content = readFileSync(ramadanSkillFile, 'utf-8');
+  return !content.includes(SKILL_MARKER);
+}
+
 function ask(question) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
@@ -54,8 +85,11 @@ async function main() {
   console.log('   Run `ramadan` to get started.');
   console.log('');
 
-  // Check if already configured
-  if (isAlreadyConfigured()) {
+  const claudeMdConfigured = isClaudeMdConfigured();
+  const skillInstalled = isSkillInstalled();
+
+  // Check if already fully configured
+  if (claudeMdConfigured && skillInstalled) {
     console.log('   ✓ Claude Code integration already configured');
     return;
   }
@@ -64,7 +98,6 @@ async function main() {
   const claudeInstalled = isClaudeInstalled();
 
   if (!claudeInstalled) {
-    // Not interactive — just check if they might want it later
     const answer = await ask('   Do you use Claude Code? (y/n) ');
 
     if (answer !== 'y' && answer !== 'yes') {
@@ -84,7 +117,7 @@ async function main() {
   } else {
     console.log('   ✓ Claude Code detected');
 
-    const answer = await ask('   Set up Claude Code integration? Type `ramadan` in Claude Code sessions. (y/n) ');
+    const answer = await ask('   Set up Claude Code integration? Type `ramadan` or `/ramadan` in Claude Code. (y/n) ');
 
     if (answer !== 'y' && answer !== 'yes') {
       console.log('   ✓ Skipped. Run `npm rebuild ramadan-cal` anytime to set it up later.\n');
@@ -99,15 +132,41 @@ async function main() {
   }
 
   // Write or append to CLAUDE.md
-  if (existsSync(claudeMd)) {
-    appendFileSync(claudeMd, CLAUDE_ENTRY);
-    console.log('   ✓ Added ramadan command to ~/.claude/CLAUDE.md');
-  } else {
-    writeFileSync(claudeMd, CLAUDE_ENTRY.trimStart());
-    console.log('   ✓ Created ~/.claude/CLAUDE.md');
+  if (!claudeMdConfigured) {
+    if (existsSync(claudeMd)) {
+      appendFileSync(claudeMd, CLAUDE_ENTRY);
+      console.log('   ✓ Added ramadan command to ~/.claude/CLAUDE.md');
+    } else {
+      writeFileSync(claudeMd, CLAUDE_ENTRY.trimStart());
+      console.log('   ✓ Created ~/.claude/CLAUDE.md');
+    }
+  }
+
+  // Create skills directory and ramadan skill
+  if (!skillInstalled) {
+    if (isConflictingSkill()) {
+      console.log('   ⚠ ~/.claude/skills/ramadan/SKILL.md already exists (not created by this package).');
+      const overwrite = await ask('   Overwrite it? (y/n) ');
+      if (overwrite !== 'y' && overwrite !== 'yes') {
+        console.log('   ✓ Skipped skill creation. You can add it manually later.');
+      } else {
+        writeFileSync(ramadanSkillFile, RAMADAN_SKILL);
+        console.log('   ✓ Created ramadan skill — type `/ramadan` in Claude Code');
+      }
+    } else {
+      if (!existsSync(skillsDir)) {
+        mkdirSync(skillsDir, { recursive: true });
+        console.log('   ✓ Created ~/.claude/skills/');
+      }
+      if (!existsSync(ramadanSkillDir)) {
+        mkdirSync(ramadanSkillDir, { recursive: true });
+      }
+      writeFileSync(ramadanSkillFile, RAMADAN_SKILL);
+      console.log('   ✓ Created ramadan skill — type `/ramadan` in Claude Code');
+    }
   }
 
-  console.log('   ✓ Done! Type "ramadan" inside Claude Code and it\'ll just work.\n');
+  console.log('   ✓ Done! Type "ramadan" or "/ramadan" inside Claude Code.\n');
 }
 
 // Handle non-interactive environments (CI, piped input)

package/src/display.js

@@ -105,6 +105,18 @@ export function render(config, view = 'full') {
     output.push(DIVIDER);
   }
 
+  // Last 10 nights — odd night reminder
+  if (currentDay >= 20) {
+    const oddNights = [20, 22, 24, 26, 28];
+    if (oddNights.includes(currentDay)) {
+      output.push('');
+      output.push(chalk.bold.magenta('✨ Tonight is an odd night — seek Laylatul Qadr'));
+    } else {
+      output.push('');
+      output.push(chalk.dim('🌙 Tonight is not an odd night'));
+    }
+  }
+
   // Eid prompt
   if (!config.eidDate && currentDay >= 28) {
     output.push('');