Monskill

{
  "name": "monskills",
  "owner": {
    "name": "Harpalsinh Jadeja"
  },
  "metadata": {
    "version": "0.7.0",
    "description": "Skills for developing apps on Monad. Assists LLM with frontend, smart contract deployment, and deploying to production"
  },
  "plugins": [
    {
      "name": "monskills",
      "source": "./",
      "version": "0.7.0",
      "description": "Skills for developing apps on Monad. Assists LLM with frontend, smart contract deployment, and deploying to production",
      "author": {
        "name": "Harpalsinh Jadeja"
      }
    }
  ]
}

{
  "name": "monskills",
  "version": "0.7.0",
  "description": "Skills for developing apps on Monad. Assists LLM with frontend, smart contract deployment, and deploying to production",
  "author": {
    "name": "Harpalsinh Jadeja",
    "url": "https://github.com/therealharpaljadeja"
  },
  "homepage": "https://skills.devnads.com",
  "repository": "https://github.com/harpalsinh/monskills",
  "license": "MIT",
  "keywords": ["monad", "ethereum", "solidity", "web3", "blockchain", "dapp"],
  "skills": [
    "./addresses",
    "./wallet",
    "./wallet-integration",
    "./why-monad",
    "./concepts",
    "./scaffold",
    "./gas",
    "./tooling-and-infra",
    "./feedback",
    "./indexer"
  ]
}

DATABASE_URL=postgresql://user:password@host/dbname?sslmode=require
STATS_SECRET=your-secret-key-here

version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "weekly"

name: CodeQL

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  analyze:
    name: Analyze
    runs-on: ubuntu-latest
    permissions:
      security-events: write
    steps:
      - uses: actions/checkout@v4
      - uses: github/codeql-action/init@v3
        with:
          languages: javascript
      - uses: github/codeql-action/analyze@v3

.DS_Store
node_modules/
.env
.env.local

import { neon } from "@neondatabase/serverless";
import { createHash } from "crypto";

export function getDb() {
  return neon(process.env.DATABASE_URL);
}

/**
 * Hash IP with a daily rotating salt for anonymous unique tracking.
 * Same IP on the same day = same hash (deduplication).
 * Different day = different hash (can't track across days).
 */
export function hashIp(ip) {
  const daySalt = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
  return createHash("sha256").update(`${ip}:${daySalt}`).digest("hex");
}

import { getDb, hashIp } from "./_lib/db.js";

const MAX_MESSAGE_LEN = 5000;
const MAX_CONTEXT_LEN = 4000;
const MAX_FIELD_LEN = 128;

const ALLOWED_SOURCES = new Set(["agent", "user"]);
const ALLOWED_SEVERITY = new Set(["low", "medium", "high"]);
const ALLOWED_CATEGORIES = new Set([
  "stuck",
  "error-loop",
  "user-complaint",
  "bug",
  "incorrect-info",
  "suggestion",
  "other",
]);

const WINDOW_SECONDS = 60 * 60;
const MAX_PER_WINDOW = 10;

function clampString(value, max) {
  if (typeof value !== "string") return null;
  const trimmed = value.trim();
  if (!trimmed) return null;
  return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
}

function looksLikeSpam(message) {
  const urlMatches = message.match(/https?:\/\//gi);
  if (urlMatches && urlMatches.length > 5) return true;
  if (/<script[\s>]/i.test(message)) return true;
  return false;
}

export default async function handler(req, res) {
  res.setHeader("Access-Control-Allow-Origin", "*");
  res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
  res.setHeader("Access-Control-Allow-Headers", "Content-Type");

  if (req.method === "OPTIONS") {
    return res.status(204).end();
  }

  if (req.method !== "POST") {
    return res.status(405).json({ ok: false, error: "Method not allowed" });
  }

  if (!process.env.DATABASE_URL) {
    return res.status(500).json({ ok: false, error: "Database not configured" });
  }

  let body = req.body;
  if (typeof body === "string") {
    try {
      body = JSON.parse(body);
    } catch {
      return res.status(400).json({ ok: false, error: "Invalid JSON body" });
    }
  }
  if (!body || typeof body !== "object") {
    return res.status(400).json({ ok: false, error: "Missing JSON body" });
  }

  // Honeypot: legitimate clients never fill this; bots usually do.
  // Silently accept to avoid signalling that filtering exists.
  if (typeof body.website === "string" && body.website.trim() !== "") {
    return res.status(200).json({ ok: true });
  }

  const message = clampString(body.message, MAX_MESSAGE_LEN);
  if (!message) {
    return res.status(400).json({ ok: false, error: "message is required" });
  }
  if (message.length < 3) {
    return res.status(400).json({ ok: false, error: "message is too short" });
  }
  if (looksLikeSpam(message)) {
    return res.status(200).json({ ok: true });
  }

  const source = clampString(body.source, MAX_FIELD_LEN);
  if (source && !ALLOWED_SOURCES.has(source)) {
    return res.status(400).json({ ok: false, error: "invalid source" });
  }

  const severity = clampString(body.severity, MAX_FIELD_LEN);
  if (severity && !ALLOWED_SEVERITY.has(severity)) {
    return res.status(400).json({ ok: false, error: "invalid severity" });
  }

  const category = clampString(body.category, MAX_FIELD_LEN);
  if (category && !ALLOWED_CATEGORIES.has(category)) {
    return res.status(400).json({ ok: false, error: "invalid category" });
  }

  const skillName = clampString(body.skill || body.skill_name, MAX_FIELD_LEN);
  const agentName = clampString(body.agent || body.agent_name, MAX_FIELD_LEN);
  const context = clampString(body.context, MAX_CONTEXT_LEN);

  const rawIp =
    req.headers["x-forwarded-for"]?.split(",")[0]?.trim() ||
    req.headers["x-real-ip"] ||
    req.socket?.remoteAddress ||
    "unknown";
  const ipHash = hashIp(rawIp);

  const sql = getDb();

  try {
    const recent = await sql`
      SELECT COUNT(*)::int AS count
      FROM feedback
      WHERE ip_hash = ${ipHash}
        AND created_at > NOW() - (${WINDOW_SECONDS} || ' seconds')::interval
    `;
    if (recent[0]?.count >= MAX_PER_WINDOW) {
      return res.status(429).json({ ok: false, error: "Too many submissions, try again later" });
    }

    const inserted = await sql`
      INSERT INTO feedback
        (source, skill_name, category, severity, message, context, agent_name, ip_hash)
      VALUES
        (${source || null}, ${skillName || null}, ${category || null},
         ${severity || null}, ${message}, ${context || null},
         ${agentName || null}, ${ipHash})
      RETURNING id
    `;
    return res.status(200).json({ ok: true, id: inserted[0].id });
  } catch (e) {
    console.error("Failed to record feedback:", e);
    return res.status(500).json({ ok: false, error: "Failed to record feedback" });
  }
}

import { readFileSync } from "fs";
import { join } from "path";
import { getDb, hashIp } from "./_lib/db.js";

const VALID_SKILLS = [
  "monskill",
  "scaffold",
  "why-monad",
  "addresses",
  "wallet",
  "wallet-integration",
  "gas",
  "concepts",
  "tooling-and-infra",
  "feedback",
  "indexer",
];

export default async function handler(req, res) {
  const skill = req.query.name;

  if (!skill || !VALID_SKILLS.includes(skill)) {
    return res.status(404).send("Skill not found");
  }

  const lang = req.query.lang === "zh" ? "zh" : null;

  let content;
  try {
    const filename = lang ? "SKILL.zh.md" : "SKILL.md";
    const filePath = skill === "monskill"
      ? join(process.cwd(), filename)
      : join(process.cwd(), skill, filename);
    content = readFileSync(filePath, "utf-8");
  } catch {
    // Fallback to English if Chinese version not found
    if (lang) {
      try {
        const fallback = skill === "monskill"
          ? join(process.cwd(), "SKILL.md")
          : join(process.cwd(), skill, "SKILL.md");
        content = readFileSync(fallback, "utf-8");
      } catch {
        return res.status(404).send("Skill not found");
      }
    } else {
      return res.status(404).send("Skill not found");
    }
  }

  // Fire-and-forget: log the download to Neon
  if (process.env.DATABASE_URL) {
    const sql = getDb();
    const rawIp =
      req.headers["x-forwarded-for"]?.split(",")[0]?.trim() ||
      req.headers["x-real-ip"] ||
      req.socket?.remoteAddress ||
      "unknown";
    const ipHash = hashIp(rawIp);

    try {
      await sql`INSERT INTO skill_downloads (skill_name, ip_hash) VALUES (${skill}, ${ipHash})`;
    } catch (e) {
      console.error("Failed to log download:", e);
    }
  }

  res.setHeader("Content-Type", "text/markdown; charset=utf-8");
  res.setHeader("Access-Control-Allow-Origin", "*");
  res.setHeader("Cache-Control", "public, s-maxage=60, stale-while-revalidate=300");
  return res.status(200).send(content);
}

import { getDb } from "./_lib/db.js";

export default async function handler(req, res) {
  if (!process.env.STATS_SECRET || req.query.key !== process.env.STATS_SECRET) {
    return res.status(401).json({ error: "Unauthorized" });
  }

  if (!process.env.DATABASE_URL) {
    return res.status(500).json({ error: "DATABASE_URL not configured" });
  }

  const sql = getDb();

  const [totals, daily, uniqueVisitors] = await Promise.all([
    sql`SELECT skill_name, COUNT(*)::int AS downloads
        FROM skill_downloads
        GROUP BY skill_name
        ORDER BY downloads DESC`,
    sql`SELECT skill_name, DATE(downloaded_at) AS date, COUNT(*)::int AS downloads
        FROM skill_downloads
        WHERE downloaded_at > NOW() - INTERVAL '30 days'
        GROUP BY skill_name, DATE(downloaded_at)
        ORDER BY date DESC, downloads DESC`,
    sql`SELECT skill_name, COUNT(DISTINCT ip_hash)::int AS unique_visitors
        FROM skill_downloads
        GROUP BY skill_name
        ORDER BY unique_visitors DESC`,
  ]);

  res.setHeader("Cache-Control", "public, s-maxage=60, stale-while-revalidate=300");
  return res.status(200).json({
    totals,
    unique_visitors: uniqueVisitors,
    daily_last_30_days: daily,
  });
}

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Changelog — MONSKILLS</title>
<meta name="description" content="Release notes and changes for monskills.">
<meta property="og:title" content="Changelog — MONSKILLS">
<meta property="og:description" content="Release notes and changes for monskills.">
<meta property="og:url" content="https://skills.devnads.com/changelog">
<meta property="og:type" content="website">
<meta property="og:image" content="https://skills.devnads.com/og.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:image" content="https://skills.devnads.com/og.png">
<link rel="icon" type="image/svg+xml" href="favicon.svg">
<link rel="stylesheet" href="shared.css">
<style>
:root {
  --bg: #0E091C;
  --fg: #c8d0e8;
  --dim: #8490b0;
  --accent: #8B75FF;
  --accent-soft: #c4b5ff;
  --border: #2d2245;
  --hover: #150e28;
}
* { margin: 0; padding: 0; box-sizing: border-box; }
html, body { min-height: 100%; }
body {
  background: var(--bg);
  color: var(--fg);
  font-family: 'SF Mono', 'Cascadia Code', 'Fira Code', 'JetBrains Mono', 'Menlo', 'Consolas', monospace;
  font-size: 14px;
  line-height: 1.6;
  display: flex;
  flex-direction: column;
  min-height: 100vh;
}
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }

/* Header bar */
.header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0.75rem 1.5rem;
  border-bottom: 1px solid var(--border);
  flex-shrink: 0;
}
.back-link {
  color: var(--dim);
  font-size: 13px;
  display: inline-flex;
  align-items: center;
  gap: 0.35rem;
  transition: color 0.15s;
}
.back-link:hover { color: var(--fg); text-decoration: none; }
.back-link svg { width: 14px; height: 14px; }
.repo-link {
  color: var(--dim);
  font-size: 13px;
  transition: color 0.15s;
}
.repo-link:hover { color: var(--fg); text-decoration: none; }

/* Page container */
.page {
  flex: 1;
  width: 100%;
  max-width: 820px;
  margin: 0 auto;
  padding: 4rem 1.5rem 4rem;
}

/* Hero */
.hero {
  text-align: center;
  margin-bottom: 4rem;
}
.hero-title {
  font-size: clamp(64px, 12vw, 140px);
  font-weight: 700;
  letter-spacing: -0.04em;
  line-height: 0.95;
  background: linear-gradient(110deg, var(--accent) 40%, var(--accent-soft) 50%, var(--accent) 60%);
  background-size: 300% 100%;
  background-position: 100% 0;
  -webkit-background-clip: text;
  background-clip: text;
  -webkit-text-fill-color: transparent;
  color: transparent;
  text-transform: uppercase;
  font-family: 'SF Mono', 'Cascadia Code', 'Fira Code', 'JetBrains Mono', 'Menlo', 'Consolas', monospace;
}
.hero-sub {
  color: var(--dim);
  font-size: 13px;
  margin-top: 1rem;
  letter-spacing: 1px;
  text-transform: uppercase;
}

/* Timeline */
.timeline {
  position: relative;
  padding-left: 2.5rem;
  --line-x: 1rem; /* shared anchor for both line and dots */
}
.timeline::before {
  content: '';
  position: absolute;
  top: 0.5rem;
  bottom: 0.5rem;
  left: var(--line-x);
  width: 2px;
  margin-left: -1px; /* center the 2px line on --line-x */
  background: linear-gradient(to bottom, var(--accent) 0%, var(--border) 30%, var(--border) 100%);
}

.entry {
  position: relative;
  padding-bottom: 3rem;
}
.entry:last-child { padding-bottom: 0; }
.entry::before {
  content: '';
  position: absolute;
  top: 10px;
  /* entry sits at padding-left of timeline (2.5rem), so to anchor at --line-x (1rem)
     in timeline coords, the dot center sits at -1.5rem in entry coords */
  left: calc(var(--line-x) - 2.5rem);
  width: 16px;
  height: 16px;
  margin-left: -8px; /* center the 16px dot on the line */
  border-radius: 50%;
  background: var(--bg);
  border: 2px solid var(--border);
  box-sizing: border-box;
  transition: border-color 0.2s, box-shadow 0.2s;
}
.entry.latest::before {
  border-color: var(--accent);
  box-shadow: 0 0 0 4px rgba(139, 117, 255, 0.15);
}

.entry-head {
  display: flex;
  align-items: baseline;
  gap: 0.75rem;
  flex-wrap: wrap;
  margin-bottom: 0.75rem;
}
.entry-version {
  font-size: 20px;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: -0.01em;
}
.entry-version a { color: inherit; }
.entry-version a:hover { text-decoration: none; opacity: 0.85; }
.entry-date {
  color: var(--dim);
  font-size: 12px;
  letter-spacing: 0.5px;
}
.entry-badge {
  display: inline-block;
  font-size: 10px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 1.5px;
  padding: 0.15rem 0.5rem;
  border-radius: 3px;
  background: rgba(139, 117, 255, 0.12);
  color: var(--accent);
  border: 1px solid rgba(139, 117, 255, 0.3);
}
.entry-badge.pre {
  background: rgba(212, 96, 95, 0.12);
  color: #d4605f;
  border-color: rgba(212, 96, 95, 0.35);
}

.entry-body {
  border: 1px solid var(--border);
  border-radius: 6px;
  padding: 1.25rem 1.5rem;
  background: rgba(21, 14, 40, 0.4);
  transition: border-color 0.2s;
}
.entry.latest .entry-body { border-color: rgba(139, 117, 255, 0.35); }

.entry-body h1, .entry-body h2, .entry-body h3 {
  color: var(--accent);
  margin: 1.1em 0 0.5em;
  font-weight: 600;
}
.entry-body h1 { font-size: 1.2em; }
.entry-body h2 { font-size: 1.08em; }
.entry-body h3 { font-size: 1em; }
.entry-body > *:first-child { margin-top: 0; }
.entry-body > *:last-child { margin-bottom: 0; }
.entry-body p { margin: 0.65em 0; }
.entry-body ul, .entry-body ol { margin: 0.65em 0; padding-left: 1.5em; }
.entry-body li { margin: 0.3em 0; }
.entry-body code {
  background: var(--hover);
  color: var(--accent);
  padding: 0.1em 0.4em;
  border-radius: 3px;
  font-size: 0.92em;
}
.entry-body pre {
  background: var(--hover);
  border: 1px solid var(--border);
  border-radius: 3px;
  padding: 0.75rem 1rem;
  overflow-x: auto;
  margin: 0.75em 0;
}
.entry-body pre code { background: none; padding: 0; color: var(--fg); }
.entry-body strong { color: var(--fg); font-weight: 600; }
.entry-body a { color: var(--accent); }
.entry-body blockquote {
  border-left: 3px solid var(--accent);
  margin: 0.75em 0;
  padding-left: 1em;
  color: var(--dim);
}

.empty-body {
  color: var(--dim);
  font-style: italic;
  font-size: 13px;
}

.state {
  text-align: center;
  padding: 4rem 1rem;
  color: var(--dim);
}
.state.error { color: #d4605f; }
.state a { color: var(--accent); }

.footer {
  text-align: center;
  color: var(--dim);
  font-size: 11px;
  padding: 1.25rem 1.5rem;
  border-top: 1px solid var(--border);
}

/* Mobile */
@media (max-width: 600px) {
  .page { padding: 2.5rem 1rem 2.5rem; }
  .hero { margin-bottom: 2.5rem; }
  .timeline { padding-left: 1.75rem; --line-x: 0.625rem; }
  .entry::before { width: 12px; height: 12px; margin-left: -6px; top: 8px; }
  .entry-body { padding: 1rem 1.1rem; }
}
</style>
</head>
<body>

<header class="header">
  <a href="/" class="back-link">
    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="15 18 9 12 15 6"/></svg>
    Back
  </a>
  <a class="repo-link" href="https://github.com/therealharpaljadeja/monskills/releases" target="_blank" rel="noopener">Releases on GitHub ↗</a>
</header>

<main class="page">
  <section class="hero">
    <h1 class="hero-title" id="hero-title">Changelog</h1>
    <div class="hero-sub">What shipped, when</div>
  </section>

  <section id="timeline" class="timeline" aria-live="polite">
    <div class="state" id="loading">Loading releases…</div>
  </section>
</main>

<footer class="footer">
  MIT License · <a href="/" >skills.devnads.com</a>
</footer>

<script src="https://cdn.jsdelivr.net/npm/gsap@3.12.7/dist/gsap.min.js"></script>
<script>
const REPO = 'therealharpaljadeja/monskills';
const API = 'https://api.github.com/repos/' + REPO + '/releases?per_page=50';
const timelineEl = document.getElementById('timeline');

function escHtml(s) {
  return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
}

function renderMarkdown(md) {
  if (!md || !md.trim()) return '';
  const esc = escHtml;
  const inline = s => esc(s)
    .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
    .replace(/(^|[\s(])\*(?!\s)([^*\n]+?)\*(?=[\s).,!?:;]|$)/g, '$1<em>$2</em>')
    .replace(/`([^`\n]+)`/g, '<code>$1</code>')
    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, text, url) => {
      const safeUrl = /^https?:\/\//.test(url) || url.startsWith('/') || url.startsWith('#') ? url : '#';
      return '<a href="' + safeUrl + '" target="_blank" rel="noopener">' + text + '</a>';
    });
  // Normalize: convert CRLF, then strip trailing whitespace from each line.
  // GitHub release bodies often have huge trailing-whitespace runs that don't
  // affect rendering but make the source noisy. Leading whitespace is preserved
  // only inside fenced code blocks.
  let raw = md.replace(/\r\n?/g, '\n');
  const lines = raw.split('\n').map(l => l.replace(/\s+$/, ''));
  let out = '';
  let i = 0;
  while (i < lines.length) {
    const line = lines[i];
    if (/^\s*```(\w*)\s*$/.test(line)) {
      let block = '';
      for (i++; i < lines.length && !/^\s*```\s*$/.test(lines[i]); i++) block += esc(lines[i]) + '\n';
      i++;
      out += '<pre><code>' + block + '</code></pre>';
      continue;
    }
    if (/^\s*(#{1,3})\s+(.+?)\s*#*$/.test(line)) {
      const l = RegExp.$1.length;
      out += '<h' + l + '>' + inline(RegExp.$2) + '</h' + l + '>';
      i++;
      continue;
    }
    if (/^\s*>\s?(.*)$/.test(line)) {
      let block = inline(RegExp.$1);
      for (i++; i < lines.length && /^\s*>\s?(.*)$/.test(lines[i]); i++) block += '\n' + inline(RegExp.$1);
      out += '<blockquote>' + block.replace(/\n/g, '<br>') + '</blockquote>';
      continue;
    }
    if (/^\s*[-*]\s+(.+)$/.test(line)) {
      out += '<ul>';
      while (i < lines.length && /^\s*[-*]\s+(.+)$/.test(lines[i])) {
        out += '<li>' + inline(RegExp.$1) + '</li>';
        i++;
      }
      out += '</ul>';
      continue;
    }
    if (/^\s*\d+\.\s+(.+)$/.test(line)) {
      out += '<ol>';
      while (i < lines.length && /^\s*\d+\.\s+(.+)$/.test(lines[i])) {
        out += '<li>' + inline(RegExp.$1) + '</li>';
        i++;
      }
      out += '</ol>';
      continue;
    }
    if (line.trim() === '') { i++; continue; }
    // Coalesce consecutive non-empty lines into one paragraph (join with space).
    let para = line.trim();
    for (i++; i < lines.length && lines[i].trim() !== '' && !/^\s*(#{1,3}\s|>|[-*]\s|\d+\.\s|```)/.test(lines[i]); i++) {
      para += ' ' + lines[i].trim();
    }
    out += '<p>' + inline(para) + '</p>';
  }
  return out;
}

function formatDate(iso) {
  if (!iso) return '';
  const d = new Date(iso);
  if (isNaN(d.getTime())) return '';
  return d.toLocaleDateString(undefined, { year: 'numeric', month: 'long', day: 'numeric' });
}

function renderReleases(releases) {
  if (!releases.length) {
    timelineEl.innerHTML = '<div class="state">No releases published yet.</div>';
    return;
  }
  const items = releases.map((r, idx) => {
    const title = r.name && r.name.trim() ? r.name : r.tag_name;
    const date = formatDate(r.published_at || r.created_at);
    const body = renderMarkdown(r.body || '') || '<p class="empty-body">No release notes.</p>';
    const badge = r.prerelease
      ? '<span class="entry-badge pre">Pre-release</span>'
      : (idx === 0 ? '<span class="entry-badge">Latest</span>' : '');
    return (
      '<article class="entry' + (idx === 0 ? ' latest' : '') + '">' +
        '<div class="entry-head">' +
          '<h2 class="entry-version"><a href="' + escHtml(r.html_url) + '" target="_blank" rel="noopener">' + escHtml(title) + '</a></h2>' +
          (date ? '<span class="entry-date">' + escHtml(date) + '</span>' : '') +
          badge +
        '</div>' +
        '<div class="entry-body">' + body + '</div>' +
      '</article>'
    );
  }).join('');
  timelineEl.innerHTML = items;

  if (window.gsap) {
    gsap.from('.entry', {
      opacity: 0,
      y: 16,
      duration: 0.45,
      ease: 'power2.out',
      stagger: 0.07
    });
  }
}

function renderError(message) {
  timelineEl.innerHTML =
    '<div class="state error">' +
      'Could not load releases: ' + escHtml(message) + '<br>' +
      '<a href="https://github.com/' + REPO + '/releases" target="_blank" rel="noopener">View on GitHub ↗</a>' +
    '</div>';
}

fetch(API, { headers: { 'Accept': 'application/vnd.github+json' } })
  .then(r => {
    if (!r.ok) throw new Error('HTTP ' + r.status);
    return r.json();
  })
  .then(data => {
    const releases = (data || []).filter(r => !r.draft);
    releases.sort((a, b) => new Date(b.published_at || b.created_at) - new Date(a.published_at || a.created_at));
    renderReleases(releases);
  })
  .catch(err => renderError(err.message || 'Unknown error'));

// Looping shine on the hero title
if (window.gsap) {
  gsap.fromTo('#hero-title',
    { backgroundPosition: '100% 0' },
    { backgroundPosition: '0% 0', duration: 2.5, ease: 'power1.inOut', repeat: -1, repeatDelay: 3 }
  );
}
</script>
</body>
</html>

openapi: 3.0.3
info:
  title: MONSKILLS API
  description: API for serving Monad development skills and viewing download analytics.
  version: 1.0.0
  contact:
    name: Harpalsinh Jadeja
    url: https://github.com/therealharpaljadeja/monskills

servers:
  - url: https://skills.devnads.com
    description: Production

paths:
  /api/skill:
    get:
      summary: Get a skill's markdown content
      description: |
        Returns the SKILL.md file for the requested skill.
        Also logs an anonymous download event (hashed IP + skill name) to the database.
      parameters:
        - name: name
          in: query
          required: true
          description: The skill identifier
          schema:
            type: string
            enum:
              - monskill
              - scaffold
              - why-monad
              - addresses
              - wallet
              - wallet-integration
      responses:
        "200":
          description: Skill markdown content
          headers:
            Content-Type:
              schema:
                type: string
                example: text/markdown; charset=utf-8
            Access-Control-Allow-Origin:
              schema:
                type: string
                example: "*"
            Cache-Control:
              schema:
                type: string
                example: public, s-maxage=60, stale-while-revalidate=300
          content:
            text/markdown:
              schema:
                type: string
                example: |
                  ---
                  name: scaffold
                  description: End-to-end guide from idea to production.
                  ---
                  # Scaffold
                  ...
        "404":
          description: Skill not found
          content:
            text/plain:
              schema:
                type: string
                example: Skill not found

  /api/stats:
    get:
      summary: Get download analytics
      description: |
        Returns aggregated download statistics per skill.
        Protected by a secret key passed as a query parameter.
      parameters:
        - name: key
          in: query
          required: true
          description: The stats secret key (must match STATS_SECRET env var)
          schema:
            type: string
      responses:
        "200":
          description: Analytics data
          content:
            application/json:
              schema:
                type: object
                properties:
                  totals:
                    type: array
                    items:
                      type: object
                      properties:
                        skill_name:
                          type: string
                          example: scaffold
                        downloads:
                          type: integer
                          example: 142
                  unique_visitors:
                    type: array
                    items:
                      type: object
                      properties:
                        skill_name:
                          type: string
                          example: scaffold
                        unique_visitors:
                          type: integer
                          example: 98
                  daily_last_30_days:
                    type: array
                    items:
                      type: object
                      properties:
                        skill_name:
                          type: string
                          example: scaffold
                        date:
                          type: string
                          format: date
                          example: "2026-03-18"
                        downloads:
                          type: integer
                          example: 12
        "401":
          description: Unauthorized — missing or incorrect key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Unauthorized
        "500":
          description: Server error — DATABASE_URL not configured
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: DATABASE_URL not configured

  /{skill}:
    get:
      summary: Skill shorthand URL
      description: |
        Convenience route that rewrites to /api/skill?name={skill}.
        Example: GET /scaffold → served by /api/skill?name=scaffold
      parameters:
        - name: skill
          in: path
          required: true
          schema:
            type: string
            enum:
              - scaffold
              - why-monad
              - addresses
              - wallet
              - wallet-integration
      responses:
        "200":
          description: Skill markdown content (same as /api/skill)
          content:
            text/markdown:
              schema:
                type: string

  /{skill}/SKILL.md:
    get:
      summary: Skill direct file URL
      description: |
        Direct path to skill file, also routed through tracking.
        Example: GET /scaffold/SKILL.md → served by /api/skill?name=scaffold
      parameters:
        - name: skill
          in: path
          required: true
          schema:
            type: string
            enum:
              - scaffold
              - why-monad
              - addresses
              - wallet
              - wallet-integration
      responses:
        "200":
          description: Skill markdown content (same as /api/skill)
          content:
            text/markdown:
              schema:
                type: string

  /SKILL.md:
    get:
      summary: Root skill index
      description: |
        Returns the master SKILL.md index file.
        Tracked as skill name "monskill".
      responses:
        "200":
          description: Master skill index markdown
          content:
            text/markdown:
              schema:
                type: string

{
  "type": "excalidraw",
  "version": 2,
  "source": "monskills",
  "elements": [
    {
      "id": "title",
      "type": "text",
      "x": 300,
      "y": 20,
      "width": 400,
      "height": 40,
      "text": "MONSKILLS — System Context (C4 Level 1)",
      "fontSize": 24,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#1e1e1e",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 1,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "agent-box",
      "type": "rectangle",
      "x": 50,
      "y": 100,
      "width": 180,
      "height": 100,
      "strokeColor": "#1971c2",
      "backgroundColor": "#d0ebff",
      "fillStyle": "solid",
      "strokeWidth": 2,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 2,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "roundness": { "type": 3 }
    },
    {
      "id": "agent-label",
      "type": "text",
      "x": 80,
      "y": 120,
      "width": 120,
      "height": 60,
      "text": "AI Agent\n(Claude, Cursor,\nCodex)",
      "fontSize": 14,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#1971c2",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 3,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "developer-box",
      "type": "rectangle",
      "x": 50,
      "y": 260,
      "width": 180,
      "height": 100,
      "strokeColor": "#1971c2",
      "backgroundColor": "#d0ebff",
      "fillStyle": "solid",
      "strokeWidth": 2,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 4,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "roundness": { "type": 3 }
    },
    {
      "id": "developer-label",
      "type": "text",
      "x": 85,
      "y": 285,
      "width": 110,
      "height": 50,
      "text": "Developer\n(Browser)",
      "fontSize": 14,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#1971c2",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 5,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "maintainer-box",
      "type": "rectangle",
      "x": 50,
      "y": 420,
      "width": 180,
      "height": 100,
      "strokeColor": "#1971c2",
      "backgroundColor": "#d0ebff",
      "fillStyle": "solid",
      "strokeWidth": 2,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 6,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "roundness": { "type": 3 }
    },
    {
      "id": "maintainer-label",
      "type": "text",
      "x": 100,
      "y": 450,
      "width": 80,
      "height": 40,
      "text": "Maintainer",
      "fontSize": 14,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#1971c2",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 7,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "monskills-box",
      "type": "rectangle",
      "x": 400,
      "y": 150,
      "width": 250,
      "height": 160,
      "strokeColor": "#2f9e44",
      "backgroundColor": "#d8f5a2",
      "fillStyle": "solid",
      "strokeWidth": 2,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 8,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "roundness": { "type": 3 }
    },
    {
      "id": "monskills-label",
      "type": "text",
      "x": 440,
      "y": 170,
      "width": 170,
      "height": 120,
      "text": "MONSKILLS\n(Vercel)\n\nStatic landing page\nServerless functions\nSkill markdown files",
      "fontSize": 14,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#2f9e44",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 9,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "neon-box",
      "type": "rectangle",
      "x": 750,
      "y": 200,
      "width": 200,
      "height": 100,
      "strokeColor": "#e8590c",
      "backgroundColor": "#fff4e6",
      "fillStyle": "solid",
      "strokeWidth": 2,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 10,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "roundness": { "type": 3 }
    },
    {
      "id": "neon-label",
      "type": "text",
      "x": 785,
      "y": 225,
      "width": 130,
      "height": 50,
      "text": "Neon PostgreSQL\n(Serverless DB)",
      "fontSize": 14,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#e8590c",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 11,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "arrow-agent-monskills",
      "type": "arrow",
      "x": 230,
      "y": 150,
      "width": 170,
      "height": 50,
      "points": [[0, 0], [170, 50]],
      "strokeColor": "#1e1e1e",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 12,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "startArrowhead": null,
      "endArrowhead": "arrow"
    },
    {
      "id": "arrow-agent-label",
      "type": "text",
      "x": 260,
      "y": 140,
      "width": 130,
      "height": 30,
      "text": "GET /scaffold\n→ text/markdown",
      "fontSize": 11,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#868e96",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 13,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "arrow-dev-monskills",
      "type": "arrow",
      "x": 230,
      "y": 300,
      "width": 170,
      "height": 60,
      "points": [[0, 0], [170, -60]],
      "strokeColor": "#1e1e1e",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 14,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "startArrowhead": null,
      "endArrowhead": "arrow"
    },
    {
      "id": "arrow-dev-label",
      "type": "text",
      "x": 270,
      "y": 270,
      "width": 100,
      "height": 30,
      "text": "GET /\n→ text/html",
      "fontSize": 11,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#868e96",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 15,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "arrow-maintainer-monskills",
      "type": "arrow",
      "x": 230,
      "y": 460,
      "width": 170,
      "height": 180,
      "points": [[0, 0], [170, -180]],
      "strokeColor": "#1e1e1e",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 16,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "startArrowhead": null,
      "endArrowhead": "arrow"
    },
    {
      "id": "arrow-maintainer-label",
      "type": "text",
      "x": 250,
      "y": 390,
      "width": 130,
      "height": 30,
      "text": "GET /api/stats?key=\n→ application/json",
      "fontSize": 11,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#868e96",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 17,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    },
    {
      "id": "arrow-monskills-neon",
      "type": "arrow",
      "x": 650,
      "y": 240,
      "width": 100,
      "height": 0,
      "points": [[0, 0], [100, 0]],
      "strokeColor": "#1e1e1e",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 18,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false,
      "startArrowhead": null,
      "endArrowhead": "arrow"
    },
    {
      "id": "arrow-neon-label",
      "type": "text",
      "x": 665,
      "y": 218,
      "width": 80,
      "height": 20,
      "text": "SQL / HTTPS",
      "fontSize": 11,
      "fontFamily": 1,
      "textAlign": "center",
      "strokeColor": "#868e96",
      "backgroundColor": "transparent",
      "fillStyle": "solid",
      "strokeWidth": 1,
      "roughness": 0,
      "opacity": 100,
      "angle": 0,
      "seed": 19,
      "version": 1,
      "isDeleted": false,
      "boundElements": null,
      "link": null,
      "locked": false
    }
  ],
  "appState": {
    "gridSize": null,
    "viewBackgroundColor": "#ffffff"
  },
  "files": {}
}