aktsmm/book-writing-workspace
book-writing-workspace/SKILL.md
Set up a reusable book-writing workspace with AI agents, instructions, prompts, and scripts. Use when creating a new book or technical writing project, bootstrapping a manuscript repository, or preparing a Markdown + Re:VIEW + PDF workflow. Triggers on "book writing workspace", "technical book project", "執筆ワークスペース", "book manuscript repo", and "Re:VIEW workspace".
$ install --global
skillsauthnpx skillsauth add aktsmm/agent-skills book-writing-workspaceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 3:09 AM11.1s49 files scanned
SKILL.md
- name:
- book-writing-workspace
- description:
- Set up a reusable book-writing workspace with AI agents, instructions, prompts, and scripts. Use when creating a new book or technical writing project, bootstrapping a manuscript repository, or preparing a Markdown + Re:VIEW + PDF workflow. Triggers on "book writing workspace", "technical book project", "執筆ワークスペース", "book manuscript repo", and "Re:VIEW workspace".
- license:
- CC BY-NC-SA 4.0
- author:
- yamapan (https://github.com/aktsmm)
Book Writing Workspace
Create a reusable manuscript workspace with folders, agents, prompts, instructions, and setup scripts.
When to use
- Book writing, technical writing, 執筆プロジェクト, Re:VIEW
- Creating a new book or technical writing project
- Bootstrapping a manuscript repository from templates
- Setting up Markdown → Re:VIEW → PDF workflow
Quick Start
python scripts/setup_workspace.py `
--name "project-name" `
--title "Book Title" `
--path "D:\target\path" `
--chapters 8
Setup Workflow
- Gather info: Project name, title, location, chapter count
- Run script:
scripts/setup_workspace.py - Review output: Confirm README, agents, prompts, and docs were created
- Customize: Edit
docs/page-allocation.md,docs/schedule.md, and.github/copilot-instructions.md
Generated Workspace
- Manuscript folders under
01_contents_keyPoints/,02_contents/, and04_images/ - AI workflow files under
.github/agents/,.github/instructions/, and.github/prompts/ - Project docs such as
README.md,docs/page-allocation.md, anddocs/schedule.md - Helper scripts such as
scripts/count_chars.pyandscripts/convert_md_to_review.py
Recommended Writing Unit
- Use 1 file = 1 section as the default manuscript unit.
- Keep chapter intro in
ch{N}-00_<title>.mdand section files inch{N}-01_...,ch{N}-02_.... - For PDF/Re:VIEW output, heading levels define hierarchy, while file split mainly improves authoring and review workflow.
Migration Checklist (Path / Naming Changes)
When reorganizing workspace paths or file naming rules, update these together:
- Docs:
docs/naming-conventions.md,docs/page-allocation.md,docs/writing-guide.md - Instructions:
templates/instructions/writing-*.instructions.md(applyToand examples) - Scripts:
templates/scripts/count_chars.py,templates/scripts/convert_md_to_review.py - Agent docs:
templates/agents/*.agent.mdif paths are explicitly written
Then verify with:
python scripts/count_chars.pypython scripts/convert_md_to_review.py
Converter Change Verification
When changing the Markdown-to-Re:VIEW converter or related templates:
- Regenerate
.refiles first withpython scripts/convert_md_to_review.py - Rebuild the final PDF, not just the intermediate
.reoutput - Inspect both a representative
.resnippet and the final PDF when the change affects footnotes, tables, images, captions, or line breaking - If the change affects running headers, side markers, or odd/even page layout, verify that
texdocumentclassusestwoside;onesidedisables odd/even-specificfancyhdrplacement - If a note semantically belongs to a table, attach the footnote marker in prose immediately before or after the table rather than inside table cells or table headers
- When checking visual PDF changes, compare against the newly archived/timestamped PDF or the updated file timestamp; some viewers keep showing a cached file when the output name stays the same
Agents Overview
| Agent | Role | Permissions |
| ------------------- | ----------------------------- | ------------------------- |
| @writing | Write and edit manuscripts | Edit 02_contents/ |
| @writing-reviewer | Review manuscripts (P1/P2/P3) | Read only |
| @converter | Convert Markdown to Re:VIEW | Edit 03_re-view_output/ |
| @orchestrator | Coordinate workflow | Delegate to agents |
Dependencies
| Tool | Purpose | Required | | ----------- | ----------------- | -------- | | Python 3.8+ | Scripts | Yes | | Git | Version control | Yes | | Docker | Re:VIEW PDF build | Optional |
Done Criteria
- [ ] Workspace folder structure created
- [ ] 4 agents deployed to
.github/agents/ - [ ]
docs/page-allocation.mdconfigured - [ ]
README.mdanddocs/schedule.mdcustomized - [ ]
/gc_Commitprompt working
Key References
| Topic | Reference | | ---------------- | ------------------------------------------------------------------------ | | Folder Structure | references/folder-structure.md | | Setup Workflow | references/setup-workflow.md | | Customization | references/customization-points.md | | Re:VIEW PDF Tips | references/review-pdf-tips.md |
Related Skills
aktsmm/drawio-diagram-forge
development
VerifiedTrustedCommunity
Generate draw.io editable diagrams (.drawio, .drawio.svg) from text, images, or Excel. Orchestrates 3-agent workflow (Analysis → Manifest → SVG generation) with quality gates. Use when creating architecture diagrams, flowcharts, sequence diagrams, or converting existing images to editable format. Supports Azure/AWS cloud icons.
11SKILL.mdUpdated Apr 2, 2026
aktsmm/agentic-workflow-guide
documentation
VerifiedTrustedCommunity
Create, review, and update Prompt and agents and workflows. Covers 5 workflow patterns, agent delegation, Handoffs, Context Engineering. Use for any .agent.md file work or multi-agent system design. Triggers on 'agent workflow', 'create agent', 'ワークフロー設計'.
11SKILL.mdUpdated Apr 2, 2026
aktsmm/vscode-extension-guide
tools
VerifiedTrustedCommunity
Guide for creating VS Code extensions from scratch to Marketplace publication. Use when: (1) Creating a new VS Code extension, (2) Adding commands, keybindings, or settings to an extension, (3) Publishing to VS Code Marketplace, (4) Troubleshooting extension activation or packaging issues, (5) Building TreeView or Webview UI, (6) Setting up extension tests.
10SKILL.mdUpdated Apr 2, 2026
aktsmm/skill-finder
data-ai
VerifiedTrustedCommunity
Full-featured Agent Skills management: Search 35+ skills, install locally, star favorites, update from sources. Use when looking for skills, installing new skills, or managing your skill collection.
10SKILL.mdUpdated Apr 2, 2026