bisac-categorizer
Skill1 starsChanged 5 days agoMITView on GitHub
Recommend BISAC subject codes (Book Industry Standards and Communications) for a book so it can be correctly shelved on Google Play Books and other distribution systems. Use when asked to choose หมวดหนังสือ / genres / subject codes, to fill section 3 of sale.md, or to review whether a book's genres match its content.
In this repository18 other files it gives its agents.
- arxiv-searchSkill
- blockframe-videoSkill
- blog-searchSkill
- book-mockupSkill
- book-promo-writerSkill
- book-sales-apiSkill
- calculatorSkill
- claude-code-docsSkill
- create-blog-postSkill
- create-slideSkill
- find-skillsSkill
- mermaid-figuresSkill
- mintlifySkill
- play-books-pricingSkill
- quick-chartSkill
- roll-diceSkill
- technical-book-writerSkill
- uikitsSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 22
All genres should be from the same subject standard — do not mix BISAC with BIC/CLIL/etc.
- Distinctive: line 47
Stay inside one subject standard: All codes must be from the same standard (for this project: BISAC).
- Distinctive: line 48
Never invent a code: If no leaf fits, use the closest true heading — BISG's own guidance is "use whatever codes currently best represent …
- Very specific: line 63
Write into sale.md → ## 3.
- Distinctive: line 78
If a platform only accepts one code, the primary alone must still stand on its own.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
BISAC Categorizer
BISAC (Book Industry Standards and Communications) subject codes are the book industry's category vocabulary. This skill turns a book's actual content into one primary code plus up to two secondary codes, written into sale.md section 3.
1. Why BISAC Matters on Google Play Books
Official rules from the Google Play Books Partner Center:
- A book requires at least one genre to be published.
- Google recommends BISAC because "genres in the Play Store are based on BISAC"; other standards are auto-mapped to their BISAC equivalent.
- Maximum 3 genres per book, the first one must be the most relevant, and all genres must come from the same subject standard.
- All genres should be from the same subject standard — do not mix BISAC with BIC/CLIL/etc.
Because only three slots exist, the ranking matters as much as the choice.
2. The Selection Procedure
1. Summarize the book in one sentence
↓
2. Pick the BISAC section that matches the CONTENT (not the audience)
↓
3. Walk down to the most specific leaf heading that is still true
↓
4. Primary = the most relevant leaf; Secondary = up to 2 distinct angles
↓
5. Verify every code character-for-character at bisg.org
↓
6. Write the result into sale.md section 3Decision rules
- Content, not reader. A book for managers about writing docs is still
COMPUTERSif the subject is documentation tooling. - Specific beats general. Choose
COM085000 COMPUTERS / Documentation & Technical WritingoverCOM000000 COMPUTERS / Generalwhenever the specific leaf is true — "General" is a fallback, never a first choice. - No duplicates of the same angle. Three codes from the same branch waste slots; secondary codes should cover genuinely different facets (e.g. tools vs. writing craft vs. workflows).
- Stay inside one subject standard. All codes must be from the same standard (for this project: BISAC).
- Never invent a code. If no leaf fits, use the closest true heading — BISG's own guidance is "use whatever codes currently best represent your book" — and say so in the note.
- Verify before writing. Codes change between BISAC editions; confirm each code + heading pair at bisg.org or in
references/verified-codes.md(a project-curated subset, verified 2026-10-26).
3. Where Codes Come From
| Resource | Use |
references/verified-codes.md | Curated subset verified against bisg.org on 2026-10-26 — start here |
| https://www.bisg.org/BISAC-Subject-Codes-main | Official free full list (browse section by section) |
| https://www.bisg.org/complete-bisac-subject-headings-list | Entry point for all sections |
Copyright note: the full BISAC list is © Book Industry Study Group and may not be redistributed. Copy only the few code/heading pairs the book actually uses into sale.md; never dump whole sections into project files.
4. Output Format
Write into sale.md → ## 3. แนะนำหมวดหนังสือ BISAC (...), following the existing structure:
* **หมวดหลัก (Primary BISAC Code):**
* **<CODE>** — `<SECTION> / <Subsection> / <Leaf>` (<คำอธิบายไทย>)
* **หมวดรองที่เกี่ยวข้อง (Secondary BISAC Codes - ถ้าแพลตฟอร์มรองรับ):**
* **<CODE>** — `<SECTION> / <Subsection> / <Leaf>` (<คำอธิบายไทย>)
* **<CODE>** — `<SECTION> / <Subsection> / <Leaf>` (<คำอธิบายไทย>)Rules for the block:
- Code in bold, heading copied exactly as BISG writes it (English, including slashes and capitalization), followed by a short Thai gloss.
- Primary first; secondaries ordered by relevance.
- If a platform only accepts one code, the primary alone must still stand on its own.
5. Common Mistakes
| Mistake | Fix |
| Invented or remembered-wrong code | Re-verify at bisg.org before writing |
COM000000 COMPUTERS / General as primary | Use the most specific true leaf |
| Choosing by audience ("for developers") | Choose by the book's actual subject |
| 3 codes that all say the same thing | One primary angle + genuinely different secondary angles |
| Mixing BISAC with another standard | One standard per book (BISAC for Google Play) |
| Reproducing whole BISAC sections in the repo | Cite only the used pairs; link the official list |
6. Final QA
- At least one code (Google requires a genre) and at most three
- Primary is the single most relevant heading
- All codes verified character-for-character against bisg.org
- All codes from the same subject standard (BISAC)
- English heading copied exactly; Thai gloss present
sale.mdsection 3 updated; sections 1, 2, 4 untouched- No bulk reproduction of the copyrighted BISAC list
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

