gitwtfhub

wtf is agent-skills?

targix/agent-skills — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

Agent skills that make an AI coding assistant compare your work against named top tier products instead of giving vague approval.

Mindmap

mindmap
  root((agent-skills))
    What it does
      Production readiness audit
      Gap ranking
      Sanity checks
    Tech stack
      Python
      Agent Skills
    Use cases
      Audit against peers
      Rank fix importance
      Catch fix loops
    Audience
      Developers
      Coding agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Get a production readiness score for a feature compared against named peer products.

REASON 2

See every gap in a feature ranked by how much fixing it would matter.

REASON 3

Catch an AI assistant repeating the same fix in a loop without real progress.

REASON 4

Run a structured sanity check midway through a coding task.

What's in the stack?

PythonMarkdownAgent Skills

How it stacks up

targix/agent-skills0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Install via the GitHub CLI skill installer for your chosen agent, such as Claude Code or Codex.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This project offers a pair of portable skills for AI coding assistants that are meant to fix a common problem: assistants like Claude Code often tell you something looks good in a vague way, without a clear standard for what good actually means. These skills give that judgment a fixed reference point instead. The main skill, called production bar, audits a feature or system you built and compares it against named, well known peer products that are considered top tier in that space. It then gives a single production readiness score based on a calibrated scale showing how far the work is from that peer level, and separately ranks every gap it finds by how much fixing it would actually matter. The goal is not to make the assistant more critical for its own sake, but to make its approval something that is earned and specific rather than another version of good enough. A second skill, common sense check, rechecks that the assistant's work still lines up with the original goal as it proceeds, catches situations where it is repeating the same small fix over and over without real progress, and provides a structured way to run an explicit sanity check partway through a task. Both skills follow an open specification called Agent Skills, which means they are not limited to Claude Code and can also be installed for other compatible assistants such as Codex, GitHub Copilot, Cursor, and Gemini CLI using a GitHub command line installer. You can preview a skill before installing it. The repository also includes eight test cases, including one that specifically checks that the skill correctly refuses to invent a score when there is not enough evidence to give one. The project is released under the MIT License.

Yoink these prompts

Prompt 1
Use production-bar to review our webhook processing flow against top peers.
Prompt 2
Explain how the production score differs from the fix importance ranking.
Prompt 3
Help me install the production-bar skill for Codex at user scope.
Prompt 4
Walk me through the evidence-blocker case in the test suite.

Frequently asked questions

wtf is agent-skills?

Agent skills that make an AI coding assistant compare your work against named top tier products instead of giving vague approval.

What language is agent-skills written in?

Mainly Python. The stack also includes Python, Markdown, Agent Skills.

What license does agent-skills use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is agent-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agent-skills for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.