<< 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 knowledgable about it ?
  • Too many video on youtube with low quality content and false promises ?
  • Do not want to pay for an ebook with an author with no credentials ?
  • Tired of coach selling video package 1000€

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 contains 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 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 with the writting of the book, update the readme.md (the one at the root of the repository), so there is a link to the book 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 better model), one credit is worth it!

Missing stuff: It does not generate images yet. Still, we could ask for illustrations, or to ask for python code generating matplotlib or other graphical elements.



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