Agent Files and Reusable Skills
Turn your working methods into supported project instructions and small SKILL.md packages that an assistant can use and you can review.
Understand the idea before the settings
Use a fictional flower-shop enquiry to turn a familiar human method into clear written guidance.
Distinguish project instructions such as AGENTS.md from task-specific skills, current business facts and the tools that perform actions.
Inspect a complete instruction-only skill example with metadata, a tone reference and a representative draft. It is teaching material, not an installed global skill.
Support, discovery locations and invocation controls vary by product and selected agent. Verify how your actual session receives the guidance instead of assuming every Markdown file is automatic memory.
Learn the concepts through prepared examples and immediate browser feedback. You do not have to write code, type terminal commands, buy a subscription or connect a real business account. Optional app actions use existing files, menus and ordinary-language questions.
What this course helps you understand
- Define one repeatable method with useful boundaries.
- Recognize supported project instruction files and scope.
- Read a skill folder and SKILL.md metadata.
- Write a precise task description and useful guidance.
- Review representative results and maintain a small library.
What you need
- A browser is enough for the prepared activities.
- Optional app practice needs VS Code and permission to use the selected feature.
- Optional live AI services have their own account, availability and cost requirements.
Complete written lessons are available. Recorded videos have not been added.
Open your prepared course folder
Start with the browser examples. When you want the practice files beside the lesson, download the Academy starter and extract it.
Open proscris-academy-starter/START-HERE.html for the course directory. Shared guidance lives in shared/; this course is in courses/agent-files-and-reusable-skills/. Its own START-HERE.html explains the included examples.
The ZIP contains prepared learning files. It does not install an application, connect an account or include paid subscriptions. Real-app actions are optional.
Your ten small steps
Follow the order, or return to the part you want to recognize again. The times are a rough guide, and there is no deadline.
- 01About 10 min
Turn a Good Working Habit Into a Readable File
Capture a repeatable working method as readable guidance, without assuming every file is loaded automatically.
- 02About 10 min
Choose One Useful Skill to Capture
Define one repeatable task with clear inputs, output and boundaries before writing a skill.
- 03About 10 min
Understand What AGENTS.md Is For
Use supported project instruction files for durable project guidance and check the selected agent’s scope rules.
- 04About 10 min
Keep Project Guidance Short and Grounded
Write concise project guidance that points to real, maintained sources instead of duplicating or inventing facts.
- 05About 10 min
Meet the Small Skill Folder
Recognize a skill directory containing SKILL.md metadata and practical instructions.
- 06About 10 min
Write a Description That Finds the Right Task
Use a clear name and task-specific description so a skill is considered for the right kind of work.
- 07About 10 min
Describe the Decisions and Useful Resources
Keep essential decisions in SKILL.md and link only supporting resources that materially help the task.
- 08About 10 min
Ask the Agent to Use the Intended Guidance
Verify how the selected session received the guidance rather than assuming a saved file was active.
- 09About 10 min
Try the Method on a Small Example
Judge a reusable method by the facts, decisions and tone in a representative small result.
- 10About 10 min
Build a Small Library That Can Evolve
Maintain a small, task-focused skill library using real examples and current project facts.
Connected courses
Keep learning with another focused course. Each has its own written lessons, examples and prepared files.
Helpful Context and Project Memory
Give your assistant the right facts, project notes and handovers without assuming it remembers everything. Learn to select sources, resolve stale information and keep useful context easy to find.
10 written lessons · Guided browser activities · Free to read
Explore this courseHow Your Agent Uses Tools
Understand file tools, the terminal, connectors, extensions and plugins while keeping your own role simple: describe the outcome and review the evidence.
10 written lessons · Guided browser activities · Free to read
Explore this courseAPI and MCP Connectors
Understand how an assistant connects to business services, what APIs and MCP do, and how to use a connected source clearly in a session.
10 written lessons · Guided browser activities · Free to read
Explore this courseEveryday Documents With an AI Assistant
Turn familiar notes into clearer messages and practical plans. Use approved sources, compare versions and keep drafting separate from approval or sending.
10 written lessons · Guided browser activities · Free to read
Explore this courseKeep your place at your own pace
Checkmarks and lesson completion stay in this browser. They are personal learning notes, without grading, certification or account sync.
Use the course library to choose your next topic, or explore the readable skill methods.