<< Go back to Posts

Making technical guides with AI

Ask anything to AI, read later



Statement

  • Interested in learning a technical topic, but you know no one who is knowledgeable about it?
  • Too many videos on YouTube with low‑quality content and false promises?
  • Don’t want to pay for an ebook from an author with no credentials?
  • Tired of a coach selling a video package for €1,000?

Ask AI to generate a technical guide for you.

Agents.md

I did it with Claude Code and Copilot Agent.

Here is the AGENTS.md / CLAUDE.md that makes it live:

Your task is to write book.
For each book, create a dedicated folder.
All books should be written in markdown.

Each folder/book should contain a `README.md`
This file is the "book preface", with the following information:

- Title
- Goal of the book
- ... (add anything relevant)
- Table of content 


A chapter should be one markdown file, with a name like `00-introduction-to-xxx.md`.

At the end of each page, add navigation links, so we can go to:

- Previous chapter (if exist)
- Next chapter (if exist)
- Entry point (README file)

When you have finished writing the book, update the `README.md` (the one at the root of the repository) so there is a link to the book's README.
Add one bullet point per book.

Link to AI reports

Note: It consumes a lot of tokens with Claude Code. I prefer to run it with Copilot Agent (with Opus 4.5 or a better model); one credit is worth it!

Missing features: it does not generate images yet.
Still, we could ask for illustrations, or request Python code that generates Matplotlib or other graphical elements.



>> You can subscribe to my mailing list here for a monthly update. <<