aztfmod/contributor-guide
.github/skills/contributor-guide/SKILL.md
Provide step-by-step guidance for contributors based on their contribution type. References CONTRIBUTING.md and project conventions. Triggers on: new contributor questions, 'how do I contribute', contribution guidance requests.
$ install --global
skillsauthnpx skillsauth add aztfmod/terraform-provider-azurecaf contributor-guideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 7:17 PM44.9s1 file scanned
SKILL.md
- name:
- contributor-guide
- description:
- Provide step-by-step guidance for contributors based on their contribution type. References CONTRIBUTING.md and project conventions. Triggers on: new contributor questions, 'how do I contribute', contribution guidance requests.
Contributor Guide
Procedure
1. Identify contribution type
Ask the contributor (or infer from context) what they want to do:
| Type | Description | |------|-------------| | new-resource | Add a new Azure resource type to the provider | | update-resource | Update an existing resource's naming constraints | | bug-fix | Fix a bug in the provider logic | | docs | Improve documentation | | test | Add or improve tests |
2. Provide guidance
For new-resource contributions:
- Check if the resource already exists:
grep '"name": "azurerm_<name>"' resourceDefinition.json - Research naming constraints (see
azure-naming-researchskill) - Create an issue describing the resource (or reference existing issue)
- Edit
resourceDefinition.json— add the entry in alphabetical order - Run
go generate && make buildto regenerate code and test - Update
CHANGELOG.mdunder## [Unreleased]→### Added - Update
README.mdresource status table - Submit PR using the template in
.github/PULL_REQUEST_TEMPLATE.md
For update-resource contributions:
- Find current definition:
grep -A 15 '"name": "azurerm_<name>"' resourceDefinition.json - Research current Azure naming rules
- Update the entry in
resourceDefinition.json - Run
go generate && make build - Update
CHANGELOG.mdunder## [Unreleased]→### Changed - Submit PR
For bug-fix contributions:
- Reproduce the bug with a test case
- Fix the code
- Verify fix with
make build - Update
CHANGELOG.mdunder## [Unreleased]→### Fixed - Submit PR
For docs contributions:
- Edit files under
docs/orREADME.md - Verify markdown renders correctly
- Submit PR
3. Reference
Point the contributor to:
.github/CONTRIBUTING.mdfor full guidelines.github/PULL_REQUEST_TEMPLATE.mdfor the PR checklistTESTING.mdfor test instructions
Related Skills
aztfmod/test-failure-diagnosis
development
VerifiedTrustedCommunity
Analyze test failure output to identify root cause and suggest fixes. Use when build or test failures occur. Triggers on: test failures, build errors, CI failures.
183SKILL.mdUpdated Apr 3, 2026
aztfmod/terraform-mock-test
development
VerifiedTrustedCommunity
Validate a resource definition end-to-end using terraform test with mock_provider azurerm. Proves the CAF-generated name is accepted by the azurerm provider schema without Azure credentials. Use after provider-build-test succeeds to run the mocked azurerm integration test.
183SKILL.mdUpdated Apr 3, 2026
aztfmod/semver-assessment
documentation
VerifiedTrustedCommunity
Analyze changes since the last release tag and determine the appropriate semantic version bump (patch/minor/major) based on CHANGELOG entries and commit types. Triggers on: release preparation, version planning.
183SKILL.mdUpdated Apr 3, 2026
aztfmod/resource-diff-report
testing
VerifiedTrustedCommunity
Compare two versions of resourceDefinition.json (e.g., branch vs main) and produce a structured change summary. Triggers on: PR review, audit, before/after comparison.
183SKILL.mdUpdated Apr 3, 2026