DavidCho1999/archaiflow-skills / bundles/construction-admin/skills/drawing-set-bookmarker
drawing-set-bookmarker
VerifiedThis skill should be used when the user has a multi-sheet architectural drawing-set PDF (typically 50–300 sheets) with no bookmarks or a flat/incorrect bookmark tree, and wants a properly bookmarked PDF plus a CSV sheet index. Trigger on "bookmark this drawing set", "add bookmarks to this PDF", "tabulate sheets", "make a sheet index", or a pasted path to a multi-sheet drawing PDF. Reads each page's title block via vision, extracts sheet number/name/discipline, groups by discipline per US National CAD Standard, and writes the bookmarked PDF + index to `docs/drawing-sets/`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.3 KB |
| assets/drawing-sets-index-template.md | markdown | 164 B |
| assets/index-template.csv | other | 64 B |
| references/bookmark_grouping_strategies.md | markdown | 3.5 KB |
| references/ncs_sheet_numbering.md | markdown | 4.3 KB |
| references/titleblock_locations.md | markdown | 4.0 KB |
| scripts/append_to_index.py | script | 1.4 KB |
| scripts/apply_bookmarks.py | script | 4.2 KB |
| scripts/init_workspace.py | script | 1.9 KB |
scripts/apply_bookmarks.py
View on GitHub#!/usr/bin/env python3
"""Apply a nested bookmark tree to a PDF using pikepdf.
Bookmark tree JSON schema:
{
"groups": [
{
"label": "Architectural (A)",
"children": [
{"label": "A-101 — FIRST FLOOR PLAN", "page": 12},
{"label": "A-102 — SECOND FLOOR PLAN", "page": 13},
{
"label": "A-501 — WALL DETAILS",
"page": 22,
"children": [
{"label": "A-501-1 — Parapet detail", "page": 22}
]
}
]
},
...
]
}
- "page" is 1-based PDF page number.
- "children" is optional; supports arbitrary nesting depth.
- Top-level "groups" become the topmost outline items; their "children" are
the nested sheet bookmarks.
- Top-level groups without an explicit "page" land on the first page of their
first child.
"""
import argparse
import json
import sys
from pathlib import Path
def _to_outline(pikepdf_mod, items, total_pages):
"""Recursively convert a list of dicts into a list of pikepdf.OutlineItem."""
outline_items = []
for entry in items:
label = entry.get("label", "")
if not label:
print(f"WARN: outline entry missing 'label' — skipped: {entry}", file=sys.stderr)
continue
children_data = entry.get("children", [])
# Determine target page: explicit > first descendant > 1
page = entry.get("page")
if page is None and children_data:
page = _first_descendant_page(children_data)
if page is None:
page = 1
if not (1 <= page <= total_pages):
print(
f"WARN: page {page} out of range (1..{total_pages}) for '{label}' — clamped",
file=sys.stderr,
)
page = max(1, min(page, total_pages))
item = pikepdf_mod.OutlineItem(label, destination=page - 1)
if children_data:
item.children.extend(_to_outline(pikepdf_mod, children_data, total_pages))
outline_items.append(item)
return outline_items
def _first_descendant_page(items):
for entry in items:
if "page" in entry:
return entry["page"]
if entry.get("children"):
p = _first_descendant_page(entry["children"])
if p is not None:
return p
return None
def main():
parser = argparse.ArgumentParser(
description=__doc__,
formatter_class=argparse.RawDescriptionHelpFormatter,
)
parser.add_argument("--input", required=True, help="Input PDF path")
parser.add_argument("--tree", required=True, help="Bookmark tree JSON path")
parser.add_argument("--output", required=True, help="Output PDF path (bookmarked)")
args = parser.parse_args()
try:
import pikepdf
except ImportError:
sys.exit(
"ERROR: pikepdf not installed. Run scripts/init_workspace.py first or "
"`pip install pikepdf`."
)
input_path = Path(args.input)
tree_path = Path(args.tree)
output_path = Path(args.output)
if not input_path.exists():
sys.exit(f"Input PDF not found: {input_path}")
if not tree_path.exists():
sys.exit(f"Bookmark tree not found: {tree_path}")
tree = json.loads(tree_path.read_text())
groups = tree.get("groups")
if not isinstance(groups, list):
sys.exit("Bookmark tree JSON must have a top-level 'groups' list.")
output_path.parent.mkdir(parents=True, exist_ok=True)
with pikepdf.open(input_path) as pdf:
total_pages = len(pdf.pages)
with pdf.open_outline() as outline:
outline.root.clear()
outline.root.extend(_to_outline(pikepdf, groups, total_pages))
pdf.save(output_path)
leaf_count = _count_leaves(groups)
print(
f"Wrote {output_path} with {len(groups)} top-level groups "
f"and {leaf_count} sheet bookmarks ({total_pages} pages)."
)
def _count_leaves(items):
count = 0
for entry in items:
children = entry.get("children", [])
if children:
count += _count_leaves(children)
else:
count += 1
return count
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |