liveBook · Manning

Chapter 6: Skills

What you will learn in chapter 6 of Build a Multi-Agent System (from Scratch)

This introduction explains why reusable procedures complement tools and how an open standard supports sharing skills.

After this chapter you will be able to

What it builds on

Section by section

Introduction

This introduction explains why reusable procedures complement tools and how an open standard supports sharing skills.

Key terms: skills, tools, procedures, Agent Skills open standard, discovery, shareable skills

6.1 Introducing Skills

6.1.1 Understanding skills

This section introduces reusable agent skills, their relationship to tools, and how the Agent Skills standard supports their packaging and use.

Key terms: skills, tools, documented workflow, Agent Skills open standard, SKILL.md, executable scripts, reference texts, discover, progressively disclosed, activating

6.1.2 Specifying skills

This section explains how the Agent Skills standard specifies a skill’s workflow, optional resources, directory bundle, and placement by scope and client.

Key terms: SKILL.md, frontmatter, YAML, name, description, procedural workflow, scripts, references, assets, skill directory

6.1.3 How LLM agents use skills

This section explains how agents discover, activate, and execute skills, including user-explicit invocation.

Key terms: discovery, activation, execution, backbone LLM, SKILL.md, procedural workflow, user-explicit invocation, Agent Skills standard

6.2 Skill: a new core type

This section introduces Skill as the framework’s representation of an Agent Skill and describes its four attributes.

Key terms: Skill, SkillFrontmatter, SkillScope, frontmatter, scope, location

6.2.1 Implementing SkillFrontmatter and SkillScope

This section relates SkillFrontmatter and SkillScope to the skill specification and identifies validation for required frontmatter fields.

Key terms: SkillFrontmatter, name, description, SkillScope, scope

6.2.2 Implementing Skill

This section implements Skill’s attributes, resource lookup, catalog entry, and validated reading of its workflow.

Key terms: Skill, frontmatter, scope, location, resources, catalog(), system prompt, template, name, description

6.3 Implementing Skill Discovery

6.3.1 Where and when to discover skills

This section identifies where the framework looks for skills and when discovery occurs relative to task execution and MCP tool discovery.

Key terms: .agents/skills, user scope, project scope, get_skills_path(), SkillScope, skill discovery, session startup, task execution, LLMAgent.run(), fresh snapshot

6.3.2 Implementing discover_skills()

This section explains how skill discovery validates bundles from project and user scopes and handles invalid or duplicate skills.

Key terms: discover_skills(), SkillScope, Skill, SkillSkippedWarning, validate_skill_dir(), SkillFrontmatter, InvalidFrontmatterError, cosmetic issues, fatal errors, collision

6.3.3 Wiring discovery into LLMAgent and TaskHandler

This section wires skill discovery into task construction and demonstrates how to verify the resulting registry.

Key terms: TaskHandler, LLMAgent.run(), skills_registry, skills_scopes, explicit_only_skills, project-scoped skills, user-scoped skills, name collisions, Skill, frontmatter

6.3.4 Disclosing discovered skills to the backbone LLM

This section explains how discovered skills are disclosed to the backbone LLM and which skills are excluded from disclosure.

Key terms: backbone LLM, run_step(), _skills_catalog, skills_catalog, <available_skills>, system prompt, _explicit_only_skills, user-explicit activation, skills catalog

6.4 Implementing Skill Activation

This section explains what skill activation adds to the backbone LLM’s context after an agent selects a skill.

Key terms: skill activation, backbone LLM, skill’s name and description, skills bundle

6.4.1 Activating a skill

This section describes the tool-based pattern chosen for skill activation and why it makes activations explicit.

Key terms: UseSkillTool, skill activation, TaskHandler, tool-call request, rollout

6.4.2 Implementing UseSkillTool

This section implements UseSkillTool to guide skill selection, validate a requested skill, and return its formatted content.

Key terms: UseSkillTool, BaseTool, skills_registry, explicit_only_skills, skill catalog, parameters_json_schema, __call__, _skills_registry, _build_skill_content, ToolCallResult

6.4.3 Wiring UseSkillTool into TaskHandler

This section wires UseSkillTool into TaskHandler and illustrates autonomous skill activation by an LLM agent.

Key terms: UseSkillTool, TaskHandler, _use_skill_tool, run_step(), backbone LLM

6.4.4 User-explicit activation: run_with_skill()

This section introduces user-explicit skill activation through LLMAgent.run_with_skill() and explains how it directs the agent to invoke the named skill.

Key terms: user-explicit skill activation, _explicit_only_skills, run_with_skill(), skill_name, prompt, max_steps, run(), UseSkillTool

6.5 Extending to MAS: Skills

This section explains how skills distinguish agents in a multi-agent system and how the framework controls their discovery and model-initiated activation.

Key terms: Skills, tools, scope, PROJECT scope, subagent, explicit_only_skills, run(), backbone LLM, activation

6.6 Summary

Where this is used later

Concepts explained in this chapter

← Chapter 5: MCP Tools Chapter 7: Memory →

These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.