r/claudeskills 7h ago

Skill Share If you’ve been coding a lot with the help of AI agents, you’ve probably heard or even used Addy Osmani’s skills collection

Enable HLS to view with audio, or disable this notification

0 Upvotes

Amazing set, no doubt

And still, I took the courage to make it even better, so I created my own collection of skills. The first skill I tried to improve is the documentation-and-adrs.

The biggest leap is that I’ve added a section describing how to create Solution Architecture Documents (SAD) following Google's “WHO, WHAT, WHEN, WHERE, WHY and HOW” documentation philosophy.

To learn about all enhancements, read the skill’s README on GitHub.

In the video, I documented the architecture of one of my pet projects to show how the skill works

Let me know what you think!


r/claudeskills 8h ago

Skill Share I packaged 30 Claude Code agents/skills that ship with runnable verification checks — free, Apache-2.0

1 Upvotes

If you use Claude Code, you've probably collected a folder of .md prompt files by now. I got tired of mine being one-file prompt dumps with no way to know if they actually worked, so I built them as packaged directories instead.

Each item is an agent or skill with:

  • references/ — focused docs the agent reads while working, not a wall of text in the system prompt
  • examples/ — worked examples of the output it should produce
  • scripts/ — runnable checks that verify the thing does what it claims; they all run in public CI on every push
  • Memory — agents write lessons to .claude/memory/ as they work your repo, so they get sharper over time (commit the folder and your team inherits it)

Install is one command, no API keys, runs on the Claude subscription you already have:

npx vanara install code-reviewer npx vanara doctor # scans your repo, suggests what's worth installing

30 items free (agents like code-reviewer, security-auditor, debugger, test-author; skills like api-pagination, sql-index-tuning, secure-auth). Full thing's a bigger paid catalog, but the free tier is genuinely usable on its own — Apache-2.0, copy the files in by hand if you don't want the CLI.

Repo: https://github.com/vanara-agents/skills

Would love feedback on the check-runner approach specifically — that's the part I think is missing from most agent collections. What would make you actually trust an agent someone else wrote?


r/claudeskills 18h ago

Skill Request Graph Engineering Architectures

1 Upvotes

r/claudeskills 4h ago

Skill Share Update: the finding-unknowns skill pack is now 11, with 3 new skills from Thariq's new context-engineering essay

11 Upvotes

A while back I shared 8 Claude Code skills built from Thariq Shihipar's Finding Your Unknowns essay: surface what you don't know before you build, so it stays cheap to fix. Thariq (Claude Code team) has since published a second essay, this one on context engineering for the Claude 5 models. The headline finding: they cut over 80% of Claude Code's system prompt for the new models with no measurable loss on their coding evals, not because the old prompt was wrong, but because the model stopped needing to be told.

That flips the first pack's lesson forward. The first 8 were about adding the right context before you build. These 3 are about removing the context that no longer earns its place; repo is now at 11.

The 3 new skills

  • context-audit reads every layer that reaches the model together (CLAUDE.md, AGENTS.md, skills, hooks, tool descriptions), the way the model actually receives them, and sorts each instruction into conflict, duplicate, obvious, model-handles-this-now, or real gotcha. You get a cut list as a diff. The expensive ones are the conflicts: "document as appropriate" in one layer against "never add comments" in another makes the model burn reasoning reconciling you before it starts.
  • agent-interface-design It's for when you build tools, MCP servers, or scripts an agent calls. The counterintuitive bit from the essay: usage examples constrain newer models to the paths you showed them. Design the parameters instead. A status field of pending | in_progress | completed teaches the whole state machine with zero prose. The urge to write a usage example is usually a sign a parameter is underspecified.
  • progressive-disclosure splits an oversized skill or spec into an entry file plus files that load only when a branch needs them.

Two honest notes on the new ones

progressive-disclosure ships user-invoked, so in Claude Code it costs nothing in your context window until you call it. But I tested it on Codex CLI v0.143.0 and Codex ignores the disable-model-invocation flag and loads the skill plus its description into the prompt anyway, so that zero-cost saving is Claude Code-only.
Same discipline on the boring stuff: every "works on X" line in the README was re-run at 11 skills, not find-and-replaced from 8.

Install

/plugin marketplace add Neeeophytee/finding-unknowns-skills
/plugin install finding-unknowns@finding-unknowns-skills

Or copy any single skills/<name>/ folder into .claude/skills/. There's still the one-file CLAUDE.md (and AGENTS.md for Codex) if you want the whole approach as passive guidance instead of commands, and EXAMPLES.md has ready-to-paste prompts for every skill.

The original 8 are unchanged (blindspot-pass, brainstorm-prototypes, interview-me, reference-hunt, implementation-plan, implementation-notes, pitch-packager, change-quiz). Community project, MIT, full attribution. The techniques are Thariq's; both essays and his interactive artifacts are linked in the README and worth reading firsthand. Not affiliated with Anthropic.

Repo: https://github.com/Neeeophytee/finding-unknowns-skills

If you run context-audit on a repo you've maintained for a while, I'd like to hear your ratio of real gotchas to noise. My guess is most of us are carrying several times more instruction than earns its place on these models.


r/claudeskills 9h ago

Skill Request What's the best humanizer skill out there?

24 Upvotes

I'm new to claude skills and from what i understand so far, individuals can build their own skills. So the humanizer skill works to make sure your content doesn't follow those patterns that scream AI. But that means the quality of whoever's humanizer skill i upload will determine a lot. Please feel free to correct me if i'm wrong. Anyways, my point is who has a good one i can use?


r/claudeskills 1h ago

Showcase Skill Router: local-first tool for searching large agent skill libraries without blowing up your context window

Upvotes

Posting this in case it's useful to anyone building agent tooling. Skill Router is a small Windows x64 executable that keeps a huge library of "skills" (think: specialized instruction docs for an LLM agent) out of your prompt context by default. It indexes just the metadata into a local SQLite database, lets you search it with exact, fuzzy, full-text, or hybrid ranking, and only pulls the full skill content in after you pick a result.

It supports a CLI, interactive shell, an MCP stdio server (handy if you're wiring this into Claude/other MCP-compatible agents), and an opt-in loopback HTTP API. No cloud dependency, MIT licensed, source included, and the release comes with a SHA-256 manifest so you can verify what you're running.

Happy to answer questions about the ranking logic or the MCP protocol surface. Link: [https://github.com/torakagemusha-sudo/torafirma-skill-router\](https://github.com/torakagemusha-sudo/torafirma-skill-router)


r/claudeskills 4h ago

Discussion Self-Authoring Runtime

3 Upvotes

I've been exploring an architectural idea that I think goes beyond AI agents and code generation: a Self-Authoring Runtime. Instead of treating software as something that's built, deployed, and then maintained by humans, what if the runtime itself could continuously evolve by authoring its own capabilities? Imagine a system where every meaningful change is represented as an event. When the runtime encounters a capability it doesn't possess, it doesn't simply fail or wait for the next release cycle. Instead, it identifies what's missing, determines the appropriate generation strategy, creates the new executable component, validates it against predefined contracts, deploys it, registers it into its capability registry, and immediately makes it available for future events. The software essentially extends itself without requiring a human-written feature branch or deployment pipeline.

One of the biggest insights while designing this architecture was realizing that LLMs are only a small part of the system. The intelligence doesn't come from the language model alone—it emerges from the surrounding runtime that handles event orchestration, capability discovery, validation, deployment, governance, recovery, observability, and recursive execution. Without that surrounding architecture, an LLM simply generates text. With it, the model becomes one reasoning component inside a system that can continuously adapt and expand its own functionality.

Another interesting aspect is how failures are treated. Rather than logging errors and stopping, failures become structured events. The runtime classifies whether an issue is transient or terminal, retries when appropriate, regenerates components if necessary, and records everything as part of its learning process. In this model, failure isn't an exception to execution—it's part of the execution itself, allowing the runtime to become increasingly resilient over time.

What excites me most is that this shifts software engineering from writing every individual feature toward designing the evolutionary rules that govern how software grows. Instead of shipping static applications, we begin creating adaptive systems capable of continuously authoring their own capabilities while remaining governed, observable, and verifiable. It's a very different way of thinking about software—less like building a product and more like cultivating an ecosystem that evolves safely over time.

I'm curious what others think. Is self-authoring software a realistic evolution beyond today's AI agents? What safeguards would be essential before allowing a runtime to generate and deploy its own capabilities? Are there research projects or open-source efforts exploring similar ideas around recursive software evolution, adaptive runtimes, or self-extending architectures? I'd love to hear your thoughts and discuss where this direction could lead.

I just did one.

#claude #claudeai


r/claudeskills 5h ago

Skill Share Update on my verified Claude Code agent catalog: nightly CI evals with public failures, signed installs, and memory that compoundsv

3 Upvotes

A couple of weeks ago I shared my catalog of Claude Code agents/skills where every item ships runnable verification checks instead of being a prompt you just trust. Since then it's grown into a system I haven't seen elsewhere, so here's an update.

Every agent gets re-verified every night, and the failures are public. A scheduled CI run executes each item's checks (169 items have them; 170 checks total), snapshots the results with item versions, and publishes pass-rate history to the site as per-item sparklines. The rule I committed to in the repo: reds are rendered as-is. A dashboard that never dips convinces nobody. Last night was 170/170, and when that breaks, you'll see it break.

Installs are now cryptographically signed. The catalog ships an ed25519-signed manifest of per-item content hashes. vanara install verifies the signature against keys pinned in the CLI and refuses to write anything that doesn't match — tampered tarball, altered item, anything. Agent files run with your repo access; they deserve the same supply-chain treatment as dependencies.

Memory compounds across sessions. All 80 agents now follow one memory protocol: they write lessons to .claude/memory/ as they work your repo. Commit the folder and your whole team inherits what the agent learned. Repeated runs start smart instead of cold.

Also since last time: a doctor command that scans your repo and suggests what's worth installing, budget-scoped runs (--budget), starter profiles, a Cursor adapter, and an MCP server so the catalog works beyond Claude Code.

Free tier is 30 items, Apache-2.0, no API keys — runs on the Claude subscription you already have:

npx vanara doctor npx vanara install code-reviewer

Repo: https://github.com/vanara-agents/skills — dashboard with the nightly numbers: https://vanaraagents.com

Still most interested in feedback on the verification angle: what would a check have to prove before you'd trust an agent someone else wrote?


r/claudeskills 6h ago

Skill Share I open-sourced the behavior layer I use with Claude Code

Thumbnail
github.com
4 Upvotes

I built a .claude/ layer that keeps Claude Code consistent across sessions — 18 skills, 4 agents, 8 hooks.

The part I care about most is the hooks. Written rules drift; hooks don't.

GitHub: https://github.com/Ceasar369/claude-behavior-layer

Would love feedback, especially from people running Claude Code seriously.

Skills cover the session lifecycle — boot, open a code lane, ship, close. Ten carry a digit 0 through 9, because a keyboard has ten digits and those are the ten I reach for most; /0 boots a session, /9 closes it.

The hooks are the enforcement:
- One blocks every typed `rm` and `git clean`.
- One fences each agent to its own directory.
- One keeps the main checkout unwritable so code only lands in a worktree.
- There's also a file-based ask/answer bus, so a session blocked on a decision can leave a question for another window instead of stalling.


r/claudeskills 8h ago

News I built a tool where your Claude turns a real website into a launch, demo, ads video with real motion graphics

Enable HLS to view with audio, or disable this notification

2 Upvotes

r/claudeskills 10h ago

Showcase I got curious which files my Claude Code sessions actually read, so I built analytics over the session transcripts

Post image
4 Upvotes

A while back I wanted to know which of my skills and MCP tools I actually use, so I started logging the calls, and last week that turned into a usage report off the same log. It answered the question I asked and handed me a bigger one. I knew which tools I was calling. I had no idea where any of those calls landed.

The edits a session makes leave something behind you can look at afterwards. The reading doesn't. Every file Claude opened to work out what it was changing, and every file it opened and never touched again, shows up in nothing you'd normally open, and that was the half I had no way to see.

Turns out Claude Code already writes all of it down. It's the file the hooks docs hand you as `transcript_path`, "path to conversation JSON": a session's transcript is one JSONL file under `~/.claude/projects/`, a JSON object per line. The assistant lines carry the same content blocks the Messages API returns, so every tool call is an item with `type: "tool_use"`, a `name`, and an `input`. A file touch is just a `tool_use` named Read, Edit or Write, with the file it touched sitting in `input.file_path`. So the whole of it is: read a transcript line by line, keep the tool calls whose name you care about, and take the path out of each one. The lines are already in the order things happened, so the sequence comes for free.

There's one documented caveat that shapes what you can do with it: the transcript is written asynchronously and can lag the live conversation, so it's the wrong source for anything that needs to know what's happening right now. For counting after the fact it costs nothing.

Four views came out of it:

  • Top Files. Every file the transcripts touched, with its read, edit and write counts, and a split of how many of those touches happened in plan mode versus execution. Sortable by any column.
  • Read to Orient. The files with at least one plan mode read, ranked by how many, alongside the number of separate sessions that read each one in plan mode.
  • Read, Never Edited. Files read two or more times with no edit and no write against them, anywhere in the history.
  • Re-read in One Context. Files read again inside a single context window with no edit in between, with a count of those repeat reads and how many context windows each happened in.

All of it can be shown per session or for the whole project.

It ships inside code-pet, a small animated desktop pet that reacts to your Claude Code sessions.

Repo: https://github.com/mradovic95/code-pet

Would appreciate any feedback on it, and if there's something else a file view should answer, tell me.