"The intuitions and best practices required to develop a high-quality Skill differ significantly from those required to build traditional software. The Agents team reviews many pull requests from excellent engineers who develop Skills in the course of their work."
"For example, if you take some of the aphorisms from PEP20 - The Zen of Python, it quickly becomes clear that writing good Python code is unlike writing good Skills. Of the 20 lines of wisdom, at least half are fully wrong or actively misleading when writing Skills."
"A Skill is a folder, not a file. Complexity is the feature. Activation is implicit pattern matching. Progressive disclosure. Context is expensive. Maximum signal per token."
"If the implementation is easy to explain, it may be a good idea. If it's easy to explain, the model already knows it. Delete it."
Perplexity's Agent Skills are built on domain expertise and modular design, featuring a library of general-purpose and vertical-specific capabilities. The Agents team emphasizes Skill quality alongside code quality, recognizing that developing high-quality Skills requires different intuitions than traditional software. Many common coding practices become ineffective in Skill creation, as illustrated by the misalignment of principles from The Zen of Python. This guide serves as a resource for engineers at Perplexity in developing and reviewing Skills, ensuring a focus on quality and user experience.
Read at Perplexity
Unable to calculate read time
Collection
[
|
...
]