Updated 1mo ago
by jbdamask
john-claude-skills
Various Claude Skills created along the way
29 GitHub stars (29)
Steady at 29 stars — no new stars in the 16 days since Sep 30.
- 30 skills (30 skills found in its SKILL.md files)
- 3 forks (3 forks)
- 1mo ago last update (Last updated 1mo ago)
Install
Skills CLI
npx skills add jbdamask/john-claude-skills
Asks which skills and agents to install. Just one: npx skills add jbdamask/john-claude-skills --skill git-push-and-tag — add -g for every project.
Claude Code
git clone https://github.com/jbdamask/john-claude-skillscp -r "john-claude-skills/plugins/beads-planner/skills/git-push-and-tag" ~/.claude/skills/
Copies the git-push-and-tag skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add jbdamask/john-claude-skills
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 30 of 34 files.
-
git-push-and-tag
Final-phase skill that stages beads, commits, pushes to the remote branch, and labels the GitHub issue as "Ready". Invoked by issue-to-beads as the last step after all beads have been filed, reviewed, and synced. Can also be used standalone when you have synced beads on an issue branch that need to be committed and pushed.
plugins/beads-planner/skills/git-push-and-tag/SKILL.md on GitHub (opens in a new tab) -
issue-to-beads
Decomposes GitHub issues into structured Beads epics, tasks, and sub-tasks with objectively verifiable acceptance criteria. Use this skill whenever the user mentions converting GitHub issues to Beads, planning work from a GitHub issue, decomposing issues into tasks, breaking down a GitHub issue, or wants to take an issue and turn it into actionable Beads work items. Also trigger when the user say…
plugins/beads-planner/skills/issue-to-beads/SKILL.md on GitHub (opens in a new tab) -
plan-only
Plan-only mode that replicates Claude Code's built-in plan mode workflow but stops after the user approves the plan — no auto-execution. Use when the user wants to plan without executing, says "plan only", "just plan", "plan but don't execute", or when another skill needs planning without triggering auto-execution. Writes the plan to .claude/plans/<slug>.md.
plugins/beads-planner/skills/plan-only/SKILL.md on GitHub (opens in a new tab) -
Context Optimization
This skill should be used when the user asks about "context window optimization", "reduce context usage", "context is filling up", "running out of context", "context bloat", "optimize my sessions", "why is context so large", or when providing advice on how to keep Claude Code sessions efficient. Provides knowledge about what consumes context and strategies to minimize waste.
plugins/context-analyzer/skills/context-optimization/SKILL.md on GitHub (opens in a new tab) -
architecture-decision-records
Write and maintain Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions. Use when documenting an architectural or technology choice, recording a design trade-off, superseding a past decision, or setting up an ADR process. Also use proactively to offer an ADR when a significant decision is made during a coding session (database, framewo…
plugins/john-skills/skills/architecture-decision-records/SKILL.md on GitHub (opens in a new tab) -
aws-learnings-add
Contribute a new lesson to the AWS Learnings library (the llms.txt-format library at github.com/jbdamask/aws-learnings-library). Use this whenever you've just debugged, fixed, or discovered a non-obvious AWS gotcha — CloudFormation, CDK, Lambda, API Gateway, IAM, S3, CloudFront, EC2, EventBridge, SQS, Secrets Manager, SSM — and want to capture it for next time. Triggers on phrases like 'add an AW…
plugins/john-skills/skills/aws-learnings-add/SKILL.md on GitHub (opens in a new tab) -
aws-learnings
Proactively catch common AWS infrastructure mistakes before they happen. Use when creating or modifying AWS components — CloudFormation, CDK, Lambda, API Gateway, IAM, S3, CloudFront, EC2, EventBridge, SQS, Secrets Manager, or SSM — to find and apply hard-won deployment lessons and avoid known pitfalls. Read-only: fetches lessons, does not add them.
plugins/john-skills/skills/aws-learnings/SKILL.md on GitHub (opens in a new tab) -
aws-quick-endpoint
Create a token-secured REST API endpoint backed by AWS Lambda and DynamoDB with full CRUD and paginated list support. Deploys via CloudFormation. Use when user wants to quickly spin up an API endpoint, create a simple REST API on AWS, build a quick data store with an API, set up a Lambda+DynamoDB endpoint, or needs a fast way to log and retrieve structured data. Triggers on "create an endpoint",…
plugins/john-skills/skills/aws-quick-endpoint/SKILL.md on GitHub (opens in a new tab) -
build-my-voice
Analyzes samples of the user's writing and creates or updates a structured `voice-profile.yaml` describing their writing voice as weighted, evidence-backed features, then asks the author a short round of questions to confirm the inferences the samples cannot settle on their own. Use when the user wants to capture, build, learn, profile, or update their writing voice or style from writing samples…
plugins/john-skills/skills/build-my-voice/SKILL.md on GitHub (opens in a new tab) -
bullshit-tests
Audit a codebase's test suite for tests that pass for no good reason — no assertions, tautologies, assertions on mocks only, swallowed exceptions, unawaited async assertions, permanently skipped tests, and other patterns that stay green no matter how broken the code is. Produces a red/yellow/green report. Use when the user says "bullshit tests", "find fake tests", "audit my test suite", "which te…
plugins/john-skills/skills/bullshit-tests/SKILL.md on GitHub (opens in a new tab) -
clone-repos
Bulk-clone a set of git repositories into a single root directory using the bundled clone-repos.sh script. Use this whenever the user wants to clone several repos at once, pull down all the repos for a project or engineering estate, lay multiple repositories out side-by-side under one folder, or set up a local working tree of many repos (e.g. as the first step before reading, documenting, or doin…
plugins/john-skills/skills/clone-repos/SKILL.md on GitHub (opens in a new tab) -
company-shorts
Generate a succinct, factual, up-to-date company research report ('Company Short') in a fixed Markdown format. Use whenever the user asks to research a company, get a company overview/profile/brief, asks 'what does <company> do', wants competitive or market intel on a business, or invokes 'company shorts'/'company short' with a company name or URL. Covers business model, products, financials, par…
plugins/john-skills/skills/company-shorts/SKILL.md on GitHub (opens in a new tab) -
cost-tracking
Track API token costs for specific operations in Claude Code. Use when the user invokes /cost-tracking to start measuring costs, or says "stop tracking", "stop cost tracking", or "how much did that cost" to stop and calculate. Tracks input, output, and cache tokens per API call and calculates USD cost using current Anthropic pricing.
plugins/john-skills/skills/cost-tracking/SKILL.md on GitHub (opens in a new tab) -
cringelinter
Lints writing for AI slop tells, including overused words, cringe phrases, structural patterns, and bro-speak declaratives that are fingerprints of LLM-generated text. Use this skill any time the user asks to check, clean, lint, or review writing for AI tells, AI slop, cringe phrases, or generic LLM-sounding language. Also use it when the user says things like "does this sound AI-written?", "make…
plugins/john-skills/skills/cringelinter/SKILL.md on GitHub (opens in a new tab) -
cringephobe
Writes documents in clear, human-sounding prose that avoids AI slop — the overused words, cringe phrases, structural tells, and bro-speak that fingerprint LLM-generated text. Use this skill whenever the user asks you to write, draft, compose, or put together a document of any kind: a blog post, essay, article, README, email, memo, announcement, newsletter, landing-page or marketing copy, report,…
plugins/john-skills/skills/cringephobe/SKILL.md on GitHub (opens in a new tab) -
devlog
Create and maintain a DEVLOG.md file capturing the development story of a project. Use this periodically over the course of a project to capture important information about the development story. Invoke when the user asks to update the devlog, create a devlog, document project progress, or capture development history. Also appropriate after completing significant milestones or before context swit…
plugins/john-skills/skills/devlog/SKILL.md on GitHub (opens in a new tab) -
ec2-claude-code
Create an Ubuntu 24.04 LTS EC2 instance with Claude Code, Playwright (headless browser testing), tmux, git, beads (bd) task tracking, and agent-deck session manager pre-installed. Use when user wants to spin up a cloud development environment, create an EC2 for Claude Code, launch a remote Claude Code instance, or set up a dev box on AWS. Supports multiple instances per account with unique naming.
plugins/john-skills/skills/ec2-claude-code/SKILL.md on GitHub (opens in a new tab) -
Five Whys Root Cause Analysis
Evidence-based root cause diagnosis using a branching five-whys investigation. Produces a likelihood-ranked list of candidate root causes — diagnosis only, never a fix. Use ONLY when the user explicitly asks to diagnose a problem or find a root cause, with phrases like "find the root cause", "diagnose this", "do a five whys check", "root cause analysis", "why is this happening", or "run a five wh…
plugins/john-skills/skills/five-whys-methodology/SKILL.md on GitHub (opens in a new tab) -
geo-reviewer
No description in the SKILL.md.
plugins/john-skills/skills/geo-reviewer/SKILL.md on GitHub (opens in a new tab) -
gilfoyle
Play Napalm Death's 'You Suffer' — the shortest song ever recorded (1.316 seconds of grindcore). Use when the user says 'gilfoyle', 'you suffer', 'napalm death', 'play the song', or wants a moment of sonic brutality.
plugins/john-skills/skills/gilfoyle/SKILL.md on GitHub (opens in a new tab) -
github-pages-deploy
Stand up a new static site (an index.html plus assets) on GitHub Pages from the terminal — creates the repo, pushes, enables Pages, waits for the build, and checks the live URL and its images actually load before handing it over. Also checks the page lays out properly on phones and laptops (no sideways scrolling, no half-empty screen) and tells you how to write the HTML so it does. Use this whene…
plugins/john-skills/skills/github-pages-deploy/SKILL.md on GitHub (opens in a new tab) -
google-doc-style-guide
Writes and edits technical documentation and application help content in a consistent house style derived from the Google developer documentation style guide — second person, active voice, present tense, sentence-case headings, procedures, lists, tables, code font, placeholders, notices, link text, accessible and inclusive language, and a word list of preferred and prohibited terms. Use whenever…
plugins/john-skills/skills/google-doc-style-guide/SKILL.md on GitHub (opens in a new tab) -
mcp-scanner
Help users evaluate whether an MCP (Model Context Protocol) tool is safe and right for them before installing it. Use when a user wants to check, scan, review, or assess a third-party MCP server from GitHub, npm, or any repository URL. Provides plain-language assessments that anyone can understand, with technical details available on request.
plugins/john-skills/skills/mcp-scanner/SKILL.md on GitHub (opens in a new tab) -
memory-checkpoint
Save and restore session state for continuity across context compressions. Invoke with "/memory-checkpoint" to save current session state, or "/memory-checkpoint your search query" to search past checkpoints by semantic similarity.
plugins/john-skills/skills/memory-checkpoint/SKILL.md on GitHub (opens in a new tab) -
my-voice
Writes or rewrites content in the user's own voice by applying an existing `voice-profile.yaml` (weights, variability, register) to the requested piece. Use when the user asks for something written or edited to sound like them — "write this in my voice", "rewrite this the way I'd say it", "make this sound like me", "use my voice profile", "draft this in my style" — including emails, posts, essays…
plugins/john-skills/skills/my-voice/SKILL.md on GitHub (opens in a new tab) -
pass-along
Write a session pass-along document to .pass-along/<YYYY-MM-DD-HHMM>-PASS-ALONG.md capturing operational state — what moved, what is half-done, which loops are still open, and the traps that wasted time — with frontmatter metadata (model, repo, branch, HEAD sha, issue tracker, issues, beads) for the agent that picks the work up. Use when the user says "write a pass-along", "/pass-along", "write a…
plugins/john-skills/skills/pass-along/SKILL.md on GitHub (opens in a new tab) -
phone-a-friend
Spawn an Opus sub-agent in extended-thinking max-effort mode to debate, critique, and pressure-test the primary agent's current thinking through an unbounded multi-turn dialogue, terminating when the agents either reach genuine consensus or cleanly agree to disagree. Supports escalating clarifying questions to the human user mid-debate, and supports the user sending the debate back for another ro…
plugins/john-skills/skills/phone-a-friend/SKILL.md on GitHub (opens in a new tab) -
plugin-marketplace-creator
Create and configure Claude Code plugin marketplaces hosted on GitHub. Use this skill when users want to set up a new plugin marketplace repository, add plugins to an existing marketplace, configure team distribution settings, or troubleshoot marketplace issues. Triggers include "create a plugin marketplace", "set up a marketplace on GitHub", "add plugins to my marketplace", "configure marketplac…
plugins/john-skills/skills/plugin-marketplace-creator/SKILL.md on GitHub (opens in a new tab) -
project-memories
Maintain durable project memories as files in the repo, using the llms.txt pattern — a docs/memories/ folder with one markdown file per memory plus a docs/memories/llms.txt index. Use when the user says "remember this for the project", "save a project memory", "add to project memories", "update a project memory", "retire a memory", "migrate memories", "set up project memories", or wants project k…
plugins/john-skills/skills/project-memories/SKILL.md on GitHub (opens in a new tab) -
repo-security-review
Security audit for GitHub repositories before installation. Use when user wants to check if a repo/app is safe to install, review install scripts for malicious code, verify an open source project isn't collecting data, or audit dependencies for suspicious packages. Triggers on phrases like "is this safe to install", "check this repo", "review this script", "audit this code", "is this sketchy".
plugins/john-skills/skills/repo-security-review/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.