Add Claude Code skill for Humanizer#1710
Conversation
Adds a Claude Code skill that provides AI agents with best practices and usage patterns for the Humanizer library. This complements the existing AGENTS.md by providing structured guidance for: - String humanization and transformation - Enum humanization/dehumanization - DateTime and TimeSpan humanization - Collection formatting - Number to words, ordinals, quantities - Byte sizes, Roman numerals, metrics The skill follows the .agents/skills/ convention used by libraries like FastAPI to embed agent instructions directly in packages. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: c50c4e28c6
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
| "person".Pluralize() => "people" | ||
| "people".Singularize() => "person" | ||
|
|
||
| "men".Pluralize() => "men" // Already plural |
There was a problem hiding this comment.
men.Pluralize() example
Pluralize() defaults inputIsKnownToBeSingular to true, so passing an already-plural word is not guaranteed to be idempotent; for irregular plurals like "men", the default path can append another plural suffix rather than returning the same word. This example teaches the unsafe call pattern and contradicts the safer overload shown below (inputIsKnownToBeSingular: false), so agents may generate incorrect inflection code for unknown-plurality inputs.
Useful? React with 👍 / 👎.
|
|
||
| ```bash | ||
| # All languages | ||
| dotnet add package Humanizer |
There was a problem hiding this comment.
dotnet add package Humanizer
This install instruction omits the repository’s documented restore constraint that the Humanizer metapackage requires tooling with the NuGet locale fix (SDK/MSBuild versions that include it). In environments still on older SDKs, this command fails during restore, so agents following this skill will recommend a non-working setup unless you add the minimum SDK note and/or the Humanizer.Core + Humanizer.Core.<locale> fallback guidance.
Useful? React with 👍 / 👎.
1 participant
Summary
.agents/skills/convention used by libraries like FastAPI to embed agent instructions directly in packagesAGENTS.mdwith structured, tool-specific guidanceWhat's Included
The skill covers:
DescriptionAttributepatternsWhy This Matters
As AI-assisted coding becomes more common, having embedded guidance helps developers get idiomatic Humanizer code on the first try. This skill is designed for tools like Claude Code that can read
.agents/skills/*/SKILL.mdfiles from installed packages.Test plan
🤖 Generated with Claude Code