skilld
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 初校.

Ask your Agent

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

This session only. Nothing lands on disk.

referencessetup-workflow.md

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

Setup Workflow

Use the setup script to create a new manuscript workspace from the bundled templates.

Command

python scripts/setup_workspace.py `
    --name "project-name" `
    --title "Book Title" `
    --path "D:\target\path" `
    --chapters 8

# Add Re:VIEW/PDF support only when the project needs it.
python scripts/setup_workspace.py `
    --name "project-name" `
    --title "Book Title" `
    --path "D:\target\path" `
    --chapters 8 `
    --with-review

Main Options

Option Meaning
--name Folder name for the new workspace
--title Human-readable book title
--path Parent directory where the workspace will be created
--chapters Number of generated chapter folders
--chapter-titles Explicit chapter names instead of defaults
--with-review Add optional Re:VIEW/PDF scaffolding
--with-materials Add materials/references/
--no-materials Skip materials/

What Gets Generated

  1. Folder structure for outlines, drafts, images, docs, and optional output
  2. Writing/review agents and writing instructions under .github/
  3. Project docs such as README.md, docs/reader-personas.md, docs/page-allocation.md, and docs/schedule.md
  4. Helper scripts such as scripts/count_chars.py
  5. Initial chapter intro files in both outline and manuscript folders
  6. Optional Re:VIEW/PDF scripts and metadata when --with-review is used

Post-Setup Checks

  1. Open the generated README.md and confirm project metadata
  2. Replace all placeholders in docs/reader-personas.md
  3. Edit docs/page-allocation.md to fit the book length
  4. Edit docs/schedule.md to replace placeholder dates
  5. Adjust .github/copilot-instructions.md for project goals and constraints

Source: SKILL.md on GitHub

Third-party checks

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

Provenance

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

Capability

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

README badge

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