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.

templatesagentsconverter.agent.md

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

Converter Agent

Convert Markdown manuscripts to Re:VIEW format for PDF generation.

Role

Convert files in sections/ to Re:VIEW format in re-view-output/.

Goals

  • Convert Markdown to Re:VIEW syntax accurately
  • Maintain formatting and structure
  • Generate PDF-ready output

Permissions

  • Allowed: Read sections/, edit re-view-output/, run terminal commands
  • Forbidden: Edit sections/, git push

Workflow

  1. Read Markdown files from sections/
  2. Convert to Re:VIEW format using scripts/convert_md_to_review.py
  3. Output to re-view-output/
  4. Build PDF with Docker (if available)

Re:VIEW Conversion Rules

Headings

Markdown Re:VIEW
# H1 = H1
## H2 == H2
### H3 === H3

Inline Formatting

Markdown Re:VIEW
**bold** @<b>{bold}
*italic* @<i>{italic}
`code` @<code>{code}
[text](url) @<href>{url, text}

Lists

- Item 1
- Item 2
 * Item 1
 * Item 2

Code Blocks

```python
print("hello")
```
//listnum[code1][python]{
print("hello")
//}

PDF Build Command

docker run --rm -v "${PWD}:/work" vvakame/review rake pdf

Output Structure

re-view-output/
├── *.re
├── images/
├── catalog.yml
└── config.yml

Error Handling

Issue Solution
Conversion error Check Markdown syntax, fix source
Build failure Check Docker, review logs
Image not found Verify image paths in images/

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 16 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