A skill packages a reusable method as instructions, sometimes with scripts, references or templates. Synthesis skills cover work such as checking sources, reviewing prose, planning code changes and keeping project decisions recoverable.
You can read the instructions as guides. An AI client that supports the format can use them in a task; how it discovers and selects a skill depends on that client. The Agent Skills specification defines the package format.
Choose a workflow
| Your task | Start with | Look for this result |
|---|---|---|
| Establish who a piece is for | Reader briefing | A particular reader, their question and what the piece will help them understand or do. |
| Examine a draft | Content quality | Passage-specific findings that preserve useful substance and voice. |
| Check a claim or quotation | Fact-checking | The source passage, attribution and the claim it supports. |
| Investigate a decision | Thinking framework | An assumption to test, a dependency to inspect or an option changed by evidence. |
| Continue a project | Project management and context maintenance | The current decision, its reason and the next unfinished action. |
| Build and review code | Code planning and implementation integrity | A change checked against requirements and meaningful failure cases. |
The complete source catalog contains the instructions and supporting files.
Inspect one result
Try the writing example about a review process said to have “dramatically improved” quality. Give the reviewer the draft and only the source material it is allowed to use.
A useful finding identifies the missing comparison, checks whether nearby text supplies it and asks for the particular evidence needed. A rewrite that invents a quality metric fails the task. A response that only names a writing pattern has not explained the reader’s problem.
Check selection and work quality separately. If the client supplies evidence that it selected the skill, inspect that evidence. If selection cannot be established, keep it unknown. The resulting review still needs to satisfy the task. Use editorial questions to improve a passage; pattern labels do not establish its author or model family.
Inspect the package before using it
The required SKILL.md contains metadata and instructions. Optional directories can hold executable scripts, reference material and assets. Read the parts relevant to the task, including executable code and its dependencies before allowing it to run.
Setup options and system documentation cover installation. Installing the catalog is different from showing that a client loaded a skill and used it successfully.
Source, maintenance and contribution
Versions, release notes, licenses, issues and development live in the synthesis-skills repository. Its license inventory distinguishes methodology content from executable code; inspect the terms for the component you use.
Rajiv Pant is the project’s named author. The governance and support policy describe how the public project is maintained. Contributions can improve instructions, examples, accessibility or runtime evidence. Include the user problem and the observation that demonstrates the improvement.