git404hub

what is bunsho fr?

eliasoulkadi/bunsho — explained in plain English

Analysis updated 2026-05-18

0Audience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

Three AI agent skills that fact check, de-robotify, and convert AI generated writing into polished PDF documents.

vibe map

mindmap
  root((Bunsho))
    What it does
      Verify facts
      Remove AI writing tells
      Generate PDFs
    Tech stack
      Node.js
      Playwright
      Chromium
    Use cases
      Polish AI drafts
      Fact check reports
      Export styled PDFs
    Audience
      AI agent builders
      Content writers
    Skills
      research
      humanize
      kagen

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

Run an AI generated report through the research skill to catch invented facts before publishing.

VIBE 2

Clean up an AI written draft with the humanize skill so it reads less mechanically.

VIBE 3

Convert a formatted HTML document into a polished PDF with the kagen skill.

VIBE 4

Copy the SKILL.md files into an AI agent's configuration to add these steps to its workflow.

what's the stack?

Node.jsPlaywrightChromium

how it stacks up fr

eliasoulkadi/bunsho0verflowme/alarm-clock0xhassaan/nn-from-scratch
Stars00
LanguageCSSPython
Last pushed2022-10-03
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencedevelopervibe coderdeveloper

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

how do i run it?

Difficulty · easy time til it works · 30min

Requires Node.js 20+ and a Chromium browser installed via npx playwright install chromium.

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

in plain english

Bunsho is a set of three related tools meant to be used together as a pipeline for turning AI generated writing into documents that read as human written, factually checked, and are exported as clean PDFs. The name means document or composition in Japanese, and the project positions itself as a companion to a separate design system project called Kami. The README frames three problems it is trying to solve. First, AI generated text often contains invented facts such as made up statistics, citations, or version numbers, and it cites a claimed 15 to 20 percent hallucination rate on factual questions from outside research. Second, AI writing tends to show detectable patterns, like uniform sentence length, overused connecting words, and repeated dashes, which detection tools such as GPTZero can catch. Third, converting HTML into PDF is often unreliable, since one common tool fails on Windows due to a missing dependency and another is deprecated. To address these, Bunsho provides three independent skills. The first, called research, checks factual claims before writing happens, drawing on techniques the README attributes to intelligence analysis methods, a public radio verification process, and open source research standards, including a ranked hierarchy of how trustworthy a source is. The second, called humanize, edits text to remove a catalogued list of sixteen patterns commonly associated with AI writing, following a five step process the README describes as detect, prune, vary, personalize and verify. The third, called kagen, converts HTML files into formatted PDFs using Playwright and Chromium instead of the tools mentioned earlier, and the README includes benchmark numbers claiming faster render times and native Windows support. To use it, you need Node.js version 20 or higher and a Chromium browser installed through Playwright. Each skill exists as a standalone file meant to be copied into an AI agent's configuration rather than installed as a typical package, and there is a build script for generating a PDF from an HTML file with a chosen paper format. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Install Playwright's Chromium and set up Bunsho's three skills in my agent configuration.
prompt 2
Use the research skill to verify the factual claims in this draft before I publish it.
prompt 3
Run the humanize skill on this AI generated paragraph and explain what it changed.
prompt 4
Use kagen to convert this HTML report into a PDF with severity badges and risk bars.

Frequently asked questions

what is bunsho fr?

Three AI agent skills that fact check, de-robotify, and convert AI generated writing into polished PDF documents.

What license does bunsho use?

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

How hard is bunsho to set up?

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

Who is bunsho for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.