Skill Best Practices

by pedronauck · documents · python, git, api, documentation, skill

Authors and structures professional-grade agent skills following the agentskills.io spec. Use when creating new skill directories, drafting procedural instructions, or optimizing metadata for discoverability. Don't use for general documentation, non-agentic library code, or README files.

Source: https://github.com/pedronauck/skills

Install

git clone https://github.com/pedronauck/skills

Tags: python, git, api, documentation, skill

⭐ 394 GitHub stars · Source: skillsdirectory

About documents MCP servers and Claude skills

documents MCP servers extend what AI agents can do inside Claude Code, Cursor, Copilot, Codex, and Windsurf. The Skiln directory indexes 16,000+ such integrations across 22 categories.

Skill Best Practices is one of hundreds of documents entries indexed on Skiln. Browse the full documents category or the complete directory of Claude skills, MCP servers, agents, commands, and hooks.

Related documents MCPs and skills

  • Audit Docs Delegation by melodic-software

    Audit skills and memory files for docs-management delegation compliance. Detects hardcoded Claude Code data and verifies proper delegation patterns.

  • Update Settings Schema by melodic-software

    Update the custom Claude Code settings JSON schema with changelog-discovered and web-verified settings.

  • Lint Md by melodic-software

    Run markdown linting validation on files using markdownlint-cli2

  • Nullable Audit by melodic-software

    Analyze nullable reference type adoption with warnings breakdown and migration recommendations

  • Specify by melodic-software

    Create formal specification for a component or behavior using TLA+, SysML, or state machines. Use for safety-critical systems.

  • Releasepr by compozy

    Guides adoption and day-to-day use of the pr-release CLI in a consuming GitHub repository: installing the binary, wiring the release GitHub Actions workflow, authoring .pr-release.yaml, following conventional commits for semantic versioning, adding custom release notes with add-note, validating with dry-run, and understanding the release-PR then merge then production-release lifecycle. Use when a project depends on compozy/releasepr (pr-release) and needs to configure, run, or troubleshoot it...

  • Improving Drf Endpoints by PostHog

    Use when editing, reviewing, or auditing DRF viewsets and serializers in PostHog. Triggers on files in posthog/api/, products/*/backend/api/, products/*/backend/presentation/, or any file importing rest_framework. Covers field typing, schema annotations, enum collision fixes, and OpenAPI spec quality — everything that flows downstream into generated TypeScript types and MCP tools.

  • Br Write Schema by Lonsdale201

    Validate POST / PUT / PATCH bodies on a better-route

Frequently asked questions

How do I install Skill Best Practices?

Add the install command above to your Claude Code, Cursor, or Windsurf MCP configuration. Most servers register via npx, a local command, or a Docker image. Refer to the source repository for environment variables and credential requirements.

Which clients support Skill Best Practices?

Any MCP-compatible client works: Claude Desktop, Claude Code CLI, Cursor, Windsurf, Zed, and VS Code with the official MCP extension. OpenAI Codex and GitHub Copilot increasingly support MCP via adapter bridges.

Is Skill Best Practices free?

The server itself is typically open source. Any upstream service (API keys, paid tiers, hosted infrastructure) may have its own pricing. Check the source repository for details.