brettatoms/agent-skills
Overview
This skill creates or updates Claude skills tailored to either a user-wide or a project-specific scope. I guide the user through choosing the right scope, apply local conventions, and produce a compact skill document plus optional reference files. The result is a ready-to-install skill that follows best practices for clarity and reuse.
How this skill works
I first confirm whether the skill should be portable across all projects or confined to the current codebase. I then fetch authoritative guidance for structure and patterns, apply local defaults for file placement and organization, and generate the skill content with progressive disclosure in mind. Finally, I return the files and instructions needed to install the skill in the correct location.
When to use it
- You want to create a new Claude skill that will be used across multiple projects.
- You need a repository-specific skill that understands project conventions and workflows.
- You want to update an existing skill’s content or metadata to improve clarity or behavior.
- You need help structuring skill content and reference material to minimize context bloat.
- You’re unsure whether a utility should be user-wide or project-specific.
Best practices
- Decide scope up front: user-wide for general tools, project-specific for repo workflows.
- Keep the primary skill document concise; move large details into a references folder.
- Include a short "when to use" description so the skill loads only when appropriate.
- Limit included context to what Claude cannot infer from current conversation.
- Follow standard output and workflow patterns to ensure predictable behavior.
Example use cases
- Create a user-level file-navigation skill usable across all your projects.
- Add a project-level skill that encodes repository testing and deployment steps.
- Update an existing skill to improve prompts and reduce redundant context.
- Convert long instructions into a compact skill with detailed references.
- Draft a skill that integrates common CLI patterns for quicker developer tasks.
FAQ
If the skill applies across multiple codebases (tools, search, file navigation), choose user scope. If it relies on repository conventions or private code, choose project scope.
How much detail should I put in the main skill file?
Keep the main file short and focused. Put extensive examples, workflows, and reference material in separate reference files to avoid overloading Claude’s active context.
7 skills
This skill helps you create or update Claude skills for user-wide or project-specific use with guided workflows.
This skill renames symbols across a codebase safely, updating definitions and all references with precision and verification.
This skill uses ast-grep to search and edit code symbols across languages, enabling finding definitions, usages, and renaming.
This skill helps you write idiomatic Janet code with functional patterns, immutability, and expressive pipelines for clarity and performance.
This skill helps you quickly locate and list project files using fd, improving file discovery and exploration.
This skill helps you search code efficiently using ripgrep to locate patterns, definitions, and usages across files.
This skill automates browser tasks using Playwright to navigate, fill forms, capture screenshots, and inspect pages with a stateful session.
