git404hub

what is luban-skill fr?

learnprompt/luban-skill — explained in plain English

Analysis updated 2026-05-18

197ShellAudience · developerComplexity · 2/5Setup · easy

tl;dr

An AI agent skill that reviews and polishes other AI agent skills, scoring them against benchmarks and producing a detailed improvement report.

vibe map

mindmap
  root((Luban))
    What it does
      Reviews AI skills
      Benchmarks vs peers
      Scores three axes
      Staged validated edits
    Tech stack
      Shell
      Claude Code plugin
      npx skills CLI
    Use cases
      Polish a published skill
      Get rewrite suggestions
      Turn scripts into tools
    Audience
      Developers
      Skill authors

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

what do people make with this?

VIBE 1

Review a published AI skill and get a scored comparison against similar skills online.

VIBE 2

Get a detailed report with concrete rewrite suggestions for an underused skill.

VIBE 3

Turn one-off validation scripts into permanent, documented tools for a repository.

VIBE 4

Produce a before-and-after summary card to show how a skill improved.

what's the stack?

ShellClaude Code

how it stacks up fr

learnprompt/luban-skillzarazhangrui/beautiful-feishu-whiteboardshannhk/hermes-agent-control-room
Stars197215177
LanguageShellShellShell
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencedeveloperdesignerops devops

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

how do i run it?

Difficulty · easy time til it works · 30min

Install with one npx command, or through the Claude Code plugin marketplace.

in plain english

Luban is a skill for AI coding agents that helps you improve other AI agent skills you have written. The name comes from a legendary Chinese master craftsman, and the tool is framed around the idea of taking a rough but working piece to a workshop for proper refinement rather than just asking an AI to "make it look better." The core problem it addresses is a common one: you build an AI skill that works for yourself, publish it on GitHub, and nobody installs it because the documentation is unclear, there is no evidence it works, and you have no structured way to figure out what to fix first. Luban responds to this with a five-step process. First it questions whether the skill is worth polishing at all, rather than starting changes immediately. Then it searches for comparable skills online to establish a benchmark with real URLs. Next it scores the skill against three measurement axes: structure, real-world test results, and whether the skill is actively maintained. After that it makes changes one at a time, each passing a validation gate before being kept. Finally it leaves a post-publish observation checklist for the next improvement round. What Luban delivers is a 13-section polishing report covering benchmark comparisons, an ecosystem position assessment, a scoring rubric, three specific improvement directions with one recommendation, and ready-to-use rewritten sections. It also produces a shareable summary card showing before-and-after scores, and it converts any one-off validation scripts into permanent repository tools with written-down standards. Installation is one command: npx skills add LearnPrompt/luban-skill -g. Claude Code users can also install it through the plugin marketplace. After installing, you activate it by telling your agent "let Luban review this skill" and pointing it at a skill directory, a GitHub repository link, or the contents of a SKILL.md file. The repository includes a detailed case study showing Luban used on the ai-news-radar project (about 1,000 stars), where the workflow found an 8-day data pipeline outage hidden behind green CI, removed 327 false AI-generated entries from 83,725 historical records with zero errors, and cut the number of cards rendered on the first screen by 30 percent. Every number in the case study links to the actual pull request.

prompts (copy fr)

prompt 1
Let Luban review this skill and give me a polishing report with benchmark comparisons.
prompt 2
Point Luban at my SKILL.md file and identify the top three ways to improve it.
prompt 3
Ask Luban to score my agent skill on structure, real-world testing, and maintenance.
prompt 4
Have Luban turn my one-off validation script into a permanent repository tool.

Frequently asked questions

what is luban-skill fr?

An AI agent skill that reviews and polishes other AI agent skills, scoring them against benchmarks and producing a detailed improvement report.

What language is luban-skill written in?

Mainly Shell. The stack also includes Shell, Claude Code.

How hard is luban-skill to set up?

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

Who is luban-skill for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.