gremlin

$npx mdskill add joelhooks/joelclaw/gremlin

Bootstraps Gremlin tasks by locating its repo and loading repo-local skills when outside the repo.

  • Helps agents start Gremlin work from the joelclaw side by finding the correct repository.
  • Integrates with repo-local skills shipped within the Gremlin repository for specific tasks.
  • Decides based on whether the task involves Gremlin from outside its repo or requires distinguishing guidance.
  • Presents results by directing agents to load specific skill files and follow repo-local instructions.

SKILL.md

.github/skills/gremlinView on GitHub ↗
---
name: gremlin
displayName: Gremlin Bootstrap
description: Bootstrap Gremlin work from the joelclaw side. Use when a task mentions gremlin from outside the repo and you need to locate the repo, load its shipped repo-local skill, or understand which guidance belongs to gremlin versus joelclaw.
version: 0.2.1
author: joel
tags:
  - gremlin
  - joelclaw
  - bootstrap
  - repo-local-skills
---

# Gremlin Bootstrap

This is **not** the canonical Gremlin repo skill.

Gremlin-specific skills should ship with the Gremlin repo unless they are specifically about how Gremlin plugs into the joelclaw system.

## Canonical repo-local skill

Load this first for normal Gremlin work:

- `/Users/joel/Code/badass-courses/gremlin/skills/gremlin/SKILL.md`

Then load narrower repo-local skills as needed:

- `/Users/joel/Code/badass-courses/gremlin/skills/gremlin-package-release/SKILL.md`
- `/Users/joel/Code/badass-courses/gremlin/skills/gremlin-project-setup/SKILL.md`
- `/Users/joel/Code/badass-courses/gremlin/skills/gremlin-tanstack-start/SKILL.md`

## Use this joelclaw-side skill only when

- you are outside the Gremlin repo and need to jump into it
- you need to distinguish repo-local Gremlin guidance from joelclaw-specific automation/integration guidance
- you are updating joelclaw prompts, routing, or memory surfaces that refer to Gremlin

## Rules

1. Prefer the repo-local Gremlin skill for Gremlin truth.
2. Do not let joelclaw-owned prompts drift into owning Gremlin repo policy.
3. If a Gremlin skill is generally useful to Gremlin contributors, move it into the Gremlin repo instead of expanding this file.

More from joelhooks/joelclaw

SkillDescription
add-skillCreate new joelclaw skills with the idiomatic process — repo-canonical, symlinked, git-tracked, slogged. Triggers on 'add a skill', 'create skill', 'new skill', 'canonical skill', 'make a skill for', or any request to formalize a process or domain into a reusable skill.
adr-skillCreate and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept/reject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.
agent-discovery"Optimize websites, docs, and product surfaces for agent discoverability and operator UX. Use when working on agent SEO/AEO/GEO, crawl policy, markdown or JSON projections, llms.txt, sitemap.md, AGENTS.md guidance, content negotiation, accessibility for browser agents, or any request to make a site easier for pi, OpenCode, Claude Code, ChatGPT, Perplexity, or other agent harnesses to find and use."
agent-loopStart, monitor, and cancel durable multi-agent coding loops via Inngest. Use when the user wants to run autonomous coding workloads, execute a PRD with multiple stories, kick off an AFK coding session, have agents implement features from a plan, or manage running loops. Triggers on "start a coding loop", "run this PRD", "implement these stories", "go AFK and code this", "check loop status", "cancel the loop", "joelclaw loop", or any request for autonomous multi-story code execution.
agent-mail>-
agent-workloads"Compatibility alias for the canonical `workflow-rig` front door. Use when older prompts mention `agent-workloads` or when you need the legacy workload-planning guidance; for new work, load `workflow-rig` first."
clawmail>-
cli-design"Design and build agent-first CLIs with HATEOAS JSON responses, context-protecting output, and self-documenting command trees. Use when creating new CLI tools, adding commands to existing CLIs (joelclaw, slog), or reviewing CLI design for agent-friendliness. Triggers on 'build a CLI', 'add a command', 'CLI design', 'agent-friendly output', or any task involving command-line tool creation."
codex-prompting"Use this skill for any request to trigger, coordinate, or craft prompts for Codex. Use when user says 'send to codex', 'use codex', 'prompt codex', 'ask codex', 'delegate to codex', 'run in codex', or asks for a Codex-first execution handoff."
content-publish"Publish content to joelclaw.com via the Convex-first pipeline. Covers the full lifecycle: draft → review → publish → revalidate → verify. Handles secret leasing, tag conventions, content types (article, tutorial, note, essay), and verification gates. Use when: 'write article about X', 'publish article <slug>', 'draft a tutorial', 'publish this', 'push to convex', or any content publishing task."