feat(skills): add DynamoMapper agent skill with reference documentation#76
Merged
feat(skills): add DynamoMapper agent skill with reference documentation#76
Conversation
- Introduced `SKILL.md` for Dynamo Mapper skill. - Provides detailed usage instructions and examples.
- Added `type-matrix.md` detailing supported types, collection rules, and nested shapes. - Added `diagnostics.md` covering common diagnostics codes and fixes. - Added `gotchas.md` highlighting pitfalls and stale documentation corrections. - Updated `SKILL.md` to include links to new reference materials. - Introduced `core-usage.md` for mapper rules, examples, defaults, and guidance.
- Added steps to install the DynamoMapper skill using `npx skills add` in `README.md`. - Documented installation process in `installation.md` for agent-based usage. - Updated `index.md` with a note about installing the repo skill.
ncipollina
reviewed
Mar 6, 2026
Contributor
ncipollina
left a comment
ncipollina
left a comment
There was a problem hiding this comment.
🎉 This is awesome!!! Nice work!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🚀 Pull Request
📋 Summary
Adds a Claude Code agent skill for DynamoMapper to help AI assistants generate accurate, idiomatic DynamoMapper code without relying on stale documentation.
The skill provides:
SKILL.mdentry point that routes Claude to the correct reference file based on the task (mapper authoring, type lookup, or diagnostics)core-usage.md: Mapper shape, attribute behavior ([DynamoMapper],[DynamoField],[DynamoIgnore],[DynamoMapperConstructor]), constructor rules, and common patternstype-matrix.md: Supported scalar types, nullable handling, nested object support, collection rules, and hard limitsdiagnostics.md: Generator diagnostics (DM0001–DM0002+), causes, and likely fixesgotchas.md: Stale-doc traps and non-obvious rules (hook signatures, converter constraints, naming rules)Also updates README and docs site to include installation instructions for the skill.
✅ Checklist
🧪 Related Issues or PRs
💬 Notes for Reviewers
references/gotchas.mdis the most important file: it captures places where public docs are known to be stale or misleading so Claude doesn't produce wrong guidance.descriptionfield inSKILL.mdis intentionally verbose so Claude can match it accurately against user intent.