The resources/ Tool Cabinet¶
Think of this folder as a tool cabinet. When you get stuck, take only the card you need now. You do not need to read every file from top to bottom.
🧭 What are you stuck on?¶
| What you want to do now | Open this first |
|---|---|
| I have never coded and do not know where to start | setup-guide.en.md |
| I want to follow the complete learning map | Home → Stage 0 |
| I see a term but do not know what it means | Term lookup |
| I cannot tell these names apart: OpenRouter = unified model API/router; Ollama = local model runtime; OpenCode/Pi = coding agents/toolkits | cli-agents-guide.en.md |
| I want to build my first action card (Skill), tool connector (MCP server), or document workflow | Hands-on recipes |
| I wrote a tool description (tool schema), but the model keeps choosing the wrong tool | schema-design-cheatsheet.en.md |
| I need a tool for Notion, Office, a database, or a browser | mcp-skills-catalog.en.md |
| I want to choose a course or check whether a certificate helps | courses.en.md |
| I want to know whether an agent works in a terminal, editor, cloud, or my own device | agent-paradigms.en.md |
| I want a helper-agent (subagent) dispatch example I can copy now | subagent-cookbook.en.md |
| I want to design, combine, or debug helper agents (subagents) | subagent-advanced.en.md |
| I want to write content or send a PR to this project | style-guide.en.md |
🧩 Five words to know first¶
- Reference: something you return to when stuck, not another required course.
- Guide: helps you make choices along one path.
- Cookbook: gives you small, complete examples you can follow.
- Catalog: keeps many tools in one searchable, comparable place.
- Glossary: gives a short definition, then sends you to the chapter with the full explanation.
📚 All 11 references¶
The left column merges resources of the same type. This table stays visible because learners need to see which entrances exist.
| Type | File | Best time to read it | What it does not do |
|---|---|---|---|
| Start and choose | setup-guide.en.md | Your first choice among Web, Desktop, IDE, CLI, and API | Does not replace each product’s current installation page |
| glossary.en.md | Look up one term in 30 seconds | Does not replace a full chapter or practice | |
| cli-agents-guide.en.md | Separate models, model entrances (routers), execution environments (runtimes), and coding agents | Does not grant permissions or choose a paid plan for you | |
| courses.en.md | Compare courses, practice depth, and certificate limits | Does not promise that a certificate gets you a job | |
| Build and debug | cookbook.en.md | Build a Skill, MCP, Office, Gemini Notebook, Zotero, or local CLI workflow | Does not turn every topic into a textbook |
| schema-design-cheatsheet.en.md | A tool or its parameters are often wrong | Does not teach complete MCP server installation | |
| Search and position | mcp-skills-catalog.en.md | Find a tool connector (MCP server) or action card (Skill) by job | Listing does not mean risk-free or permanently available |
| agent-paradigms.en.md | See whether an agent runs in a terminal, editor, cloud, or your own device | Is not a product leaderboard | |
| Advanced subagents | subagent-cookbook.en.md | Copy a helper-agent dispatch example first | Does not explain every design principle |
| subagent-advanced.en.md | Design, combine, and debug helper agents | Is not where a first-time CLI-agent user should begin | |
| Maintain the project | style-guide.en.md | Write entries, translate, build tables, or send a PR | Is not required reading for ordinary learners |
🔁 Where do you return next?¶
- First-time learner: return to Stage 0.
- Want to finish work with a CLI: return to Track A1.
- Want to build an Agent: return to Stage 3.
- Want to choose an entrance again: return to Home.
✅ 30-second completion check¶
- I know which one file I need now.
- I am not treating the catalog as a textbook to read from start to finish.
- I know where to return on the main route afterward.
Why not combine all 11 references into one book?
They solve different problems. The Glossary is a 30-second lookup, a Stage builds a concept in a few minutes, the Cookbook helps you make something, and the Catalog helps you search for tools. Mixing them into one book would make the entrance harder to find.
For chapter-length Chinese lessons, continue with Hello-Agents. This project helps you find the route instead of rewriting another long textbook.
Maintainers: locale coverage and rules for a new reference
All 11 references above have Traditional Chinese, English, and Simplified Chinese versions. Before adding another reference, confirm all four rules:
- It has a job that no existing file can replace.
- At least three stages, tracks, or branches will need it.
- Terms, URLs, limitations, and safety rules can stay aligned across three locales.
- If it serves only one chapter, keep it in that chapter instead of creating another file.
Traditional Chinese is the source version: zh-TW is canonical. Verify official sources first. If the answer is unknown, say so instead of guessing. Do not preserve drifting GitHub stars, fixed totals, and line counts.
Before submitting a change, check the MCP/Skills catalog, Cookbook, style guide, and CONTRIBUTING.