SKILL.md
Code review skill (contentstack-cli-tsgen)
CLI and docs
- Help text,
static examples, and README/oclif-generated docs stay in sync when flags or behavior change. - Short command name
tsgen/TSGENcomes fromcsdxConfigin [package.json](../../package.json).
Product language
- Prefer Delivery token flows; GraphQL requires delivery token in code paths—reviewers should catch CMA-centric wording that misleads users.
Errors
printFormattedErrorin [src/lib/helper.ts](../../src/lib/helper.ts) mapserror_codeto user-facing messages; extend switches carefully for backward compatibility.
Dependency on the library
- Business logic for
generateTS/graphqlTSbelongs in@contentstack/types-generator(npm, GitHub). CLI changes should orchestrate and format, not reimplement generation.
Tests and CI
- Integration tests depend on
csdxandTOKEN_ALIAS; document env needs when adding cases. - Backward compatibility: Avoid breaking changes to flags, exit behavior, or output file contract without semver intent.
- Supply chain:
.github/workflows/sca-scan.ymlruns Snyk on pull requests.
Optional severity
- Blocker: Wrong token type handling, broken
csdxcontract, security issues. - Major: Missing integration coverage for new flags, unclear errors.
- Minor: Copy, non-breaking refactors.