Skill Best Practices
If you're building skills for AI agents, this walks you through the full authoring workflow: validation scripts that catch metadata errors before you commit, a clear directory structure (scripts, references, assets), and progressive disclosure rules to keep your main logic under 500 lines. It enforces third-person imperative style and includes a Python validator you run inline. The bundled path rule is smart: it makes you resolve helper script paths relative to the skill directory so agents don't silently depend on working directory state. It's opinionated about what belongs in a skill versus general docs, which keeps things focused. Worth using if you're shipping reusable agent tooling and want consistency across a catalog.
- skills.sh installs
- 476
- GitHub stars
- 652
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pedronauck/skills --skill skill-best-practices --agent claude-codeInstalls into .claude/skills of the current project.
Files
If you're building skills for AI agents, this walks you through the full authoring workflow: validation scripts that catch metadata errors before you commit, a clear directory structure (scripts, references, assets), and progressive disclosure rules to keep your main logic under 500 lines. It enforces third-person imperative style and includes a Python validator you run inline. The bundled path rule is smart: it makes you resolve helper script paths relative to the skill directory so agents don't silently depend on working directory state. It's opinionated about what belongs in a skill versus general docs, which keeps things focused. Worth using if you're shipping reusable agent tooling and want consistency across a catalog.
Browse the repository on GitHubSponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/pedronauck/skills
- Categories
- Documentation, AI & Agent Building
- First seen
- Jun 3, 2026
More from pedronauck/skills
All 70- React473
- Tailwindcss471
- Agent Browser466
- Context7435
- Electron Builder433
- Refactoring Analysis425
- Zod410
- Git Rebase395
- Next Best Practices394
- Systematic Debugging388
- Shadcn383
- Tanstack380
- Vitest376
- Zustand362
- Vercel React Best Practices360
- Brainstorming356
- A11y Testing355
- Hormozi Ad Factory353
- Humanizer346
- Evolution Api344
- To Prompt343
- Brand Storytelling342
- Drizzle Safe Migrations339
- Vercel Composition Patterns334
Recommended
More Documentation
walkthrough-videojezweb/claude-skillsGenerate professional walkthrough videos from app screenshots or live sites using Remotion. Smooth transitions, zoom effects, text overlays, and optional voiceo473skills.sh installs
fbafastapi-practices/skillsFastAPI Best Architecture (fba) project development guide. Use when working in fba projects to design, implement, review, or document APIs, Schema, Service, CRU472skills.sh installs
google-workspace-clihoodini/ai-agents-skillsInteract with all Google Workspace APIs via the gws CLI. Use when managing Drive files, sending/reading Gmail, creating Calendar events, reading/writing Sheets/455skills.sh installs
react-useeffectdavila7/claude-code-templatesReact useEffect best practices from official docs. Use when writing/reviewing useEffect, useState for derived values, data fetching, or state synchronization. T454skills.sh installs
openai-knowledgeopenai/openai-agents-pythonUse when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need a453skills.sh installs
voice-analysisjwynia/agent-skillsExtract and document a writer's distinctive voice patterns for consistent reproduction. Use when you need to capture writing voice, analyze writing style, creat451skills.sh installs