I primarily use LLMs as personal tech writers. I don’t believe in letting it do the work for me because then I’ll lose my skills.
I start with an outline with all the general steps (1, 2, 3, etc) and feed it to a new Claude chat. I will probably switch to Google Gemini because of its concept of Notebooks. Then as I go along I tell it what step I am working on, what I am doing, and sharr a lot of sanitized copypasta. I leave all internal names and IPs intact but replace external IPs with things like <GCP WAN IP> and <lab WAN IP>. Claude figures it out and replaces it for the sanitized docs. When I am done I ask it to build the full run book with code blocks and it spits out a fully formatted, cataloged (1.1, 1.2, 1.3, etc), spell checked and noted .md file that I can load into Standard Notes or Obsidian. You can also add to the process, vouce notes if you don’t want to type and the LLM will add the text in for you.
PS: If you need a quick way to view Markdown files from any device, you can use this html file. Please host your own copy just in case my neocities page ever goes away. I need to ask Claude to add the viewing options it used on the guide.
As far as prompts, I just keep them straight forward and clear. Below are the two I used to create the html I shared.
This is a useful runbook. Recreate this runbook as a guide for public consumption. Output in a single html file. Include codeblocks and diagrams. Fully sanitized of any reference to my internal network, nodes, IPs, etc.
Good. Please make a version of the html that allows for dark mode, low light lite mode, and high contrast monochrome e-ink mode as selectable viewing options for balanced accessibility.
Comments
I’m more interested in the way you had Claude document your setup. How did you make sure it didn’t access secrets? Did you copy paste stuff?
I primarily use LLMs as personal tech writers. I don’t believe in letting it do the work for me because then I’ll lose my skills.
I start with an outline with all the general steps (1, 2, 3, etc) and feed it to a new Claude chat. I will probably switch to Google Gemini because of its concept of Notebooks. Then as I go along I tell it what step I am working on, what I am doing, and sharr a lot of sanitized copypasta. I leave all internal names and IPs intact but replace external IPs with things like <GCP WAN IP> and <lab WAN IP>. Claude figures it out and replaces it for the sanitized docs. When I am done I ask it to build the full run book with code blocks and it spits out a fully formatted, cataloged (1.1, 1.2, 1.3, etc), spell checked and noted .md file that I can load into Standard Notes or Obsidian. You can also add to the process, vouce notes if you don’t want to type and the LLM will add the text in for you.
Sounds good. Can you share some prompts for inspiration? Have any skills.md’s?
PS: If you need a quick way to view Markdown files from any device, you can use this html file. Please host your own copy just in case my neocities page ever goes away. I need to ask Claude to add the viewing options it used on the guide.
https://smoores.neocities.org/parchment.html
EDIT: That’s all Claude. I have no HTML skills at all and I just needed a tool.
This is the tech-writer skill I use.
https://drive.proton.me/urls/ZA9N573TFM#dSc7OnnJnyQ4
As far as prompts, I just keep them straight forward and clear. Below are the two I used to create the html I shared.
Thank you!
Sign in to comment. Sign in