All skills
aktsmm avatar

/book-writing-workspace

@b7ad2f8
by yamapanaktsmm/agent-skills26 stars
4

Operate a reusable technical book manuscript workspace with writing structure, reader persona SSOT, review rules, and optional Markdown to Re:VIEW/PDF support. Use when organizing a book manuscript repo, defining or reviewing target readers, standardizing chapter/section files, setting writing/review agents, handling publisher proof comments, or assessing an existing writing workspace. Triggers on book writing workspace, reader persona, reader audience, 読者ペルソナ, persona SSOT, technical book project, 執筆ワークスペース, manuscript workflow, Re:VIEW workspace, proof PDF, annotated proof, publisher proof comments, 校正, 校正注釈, and 初校.

Use this Skill: https://skilld.dev/gh/aktsmm/agent-skills/book-writing-workspace

This session only. Nothing lands on disk.

templatesdocsnaming-conventions.md

≈475 tokens on demand. Your agent reads this file only when SKILL.md points to it.

File Naming Conventions

Naming rules for files and folders in the book project.

Manuscript Files

Pattern

ch{chapter}-{number}_{title}.md

Components

Component Description Example
{chapter} Chapter number (0-9) 0, 1, 5
{number} Sequence (00-99) 00, 01, 10
{title} Section title (Japanese) 日常業務を爆速化する

Examples

Filename Usage
ch0-00_Copilotで何が変わったのか.md Chapter 0
ch1-00_事例ギャラリー.md Chapter 1
ch2-01_Excelタスク自動化.md Chapter 2, #1
ch2-02_メール作成支援.md Chapter 2, #2

File Division Strategy

Basic Principle

1 file = 1 section

File Structure

Each chapter consists of:

  • ch{N}-00 = Chapter introduction (300-500 chars)
  • ch{N}-01 = Section 1 (2,000-6,000 chars)
  • ch{N}-02 = Section 2 (2,000-6,000 chars)
  • ch{N}-03 = Section 3 (2,000-6,000 chars)

Image Files

Pattern

fig-{chapter}-{section}-{number}.{ext}

Extensions

Extension Usage
.png Screenshots, diagrams
.jpg Photographs
.pdf Vector graphics for print

Re:VIEW Files

Pattern

ch{NN}-{slug}.re

Examples

Filename Chapter
preface.re Chapter 0
ch01-intro.re Chapter 1
postscript.re Conclusion

Notes

  1. Spaces are OK in folder titles
  2. Japanese is OK in visible titles
  3. Keep IDs alphanumeric and half-width

Source: SKILL.md on GitHub

1 warning14d5 checks · Risk SAFE
  • Gen Agent Trust Hub14d

    The skill provides a comprehensive workspace for technical book writing, including automation for manuscript management and PDF generation. All identified behaviors, such as Docker-based builds and external tool dependencies, are standard components of the intended technical publishing workflow and show no signs of malicious intent.

  • Socket14d

    No alerts

  • Snyk14d

    Risk: LOW · No issues

  • Runlayer6mo

    8/48 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at b7ad2f8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 18 hours ago.

Activeupdated last week
argument-hint
本のテーマ、原稿リポジトリ名、使いたい執筆フロー
user-invocable
true
metadata
{
  "author": "yamapan (https://github.com/aktsmm)"
}

README badge

README badge for aktsmm/agent-skills/book-writing-workspace