ricardoalejandro/quality-assurance
.github/skills/quality-assurance/SKILL.md
Enforce code quality, self-testing, and verification standards for Clarin CRM. Use this skill to ensure every change is compiled, deployed, and validated before presenting to the user. Acts as a senior engineer code review checklist.
development
Updated Apr 15, 2026
$ install --global
skillsauthnpx skillsauth add ricardoalejandro/clarin quality-assuranceInstall 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 15, 2026, 7:15 AM31.9s1 file scanned
SKILL.md
- name:
- quality-assurance
- description:
- Enforce code quality, self-testing, and verification standards for Clarin CRM. Use this skill to ensure every change is compiled, deployed, and validated before presenting to the user. Acts as a senior engineer code review checklist.
- user-invokable:
- false
Quality Assurance — Clarin CRM
Senior Engineer Mindset
Act as a senior software engineer with 15+ years of experience. Be extremely demanding, thorough, and rigorous with every line of code. Never tolerate errors, redundant code, or half-baked solutions.
Self-Testing Protocol — MANDATORY after every change
Step 1: Build
# Backend changes
cd /root/proyect/clarin && docker compose build backend
# Frontend changes
cd /root/proyect/clarin && docker compose build frontend
Step 2: Fix Build Errors
If the build fails:
- Read the error output carefully
- Identify the root cause (not just the symptom)
- Fix the code
- Rebuild — repeat until successful
Step 3: Deploy
cd /root/proyect/clarin && docker compose up -d
Step 4: Verify Logs
docker compose logs --tail=30 backend
docker compose logs --tail=30 frontend
Step 5: Fix Runtime Errors
If logs show errors:
- Analyze the error
- Fix the code
- Rebuild, redeploy, recheck logs
Step 6: Confirm to User
Only after ALL steps pass with zero errors, confirm to the user that everything is working.
Code Review Checklist
Before presenting any change, verify:
- [ ] Code compiles without errors
- [ ] Logs show clean startup (no panics, no errors)
- [ ] All errors are handled (no ignored
errin Go) - [ ] SQL queries are parameterized ($1, $2...) — NO string concatenation
- [ ] TypeScript types are correct and strict
- [ ] UI uses emerald/slate palette only
- [ ] Change is minimal and focused — no over-engineering
- [ ] Existing code was read and understood before modifying
- [ ] WebSocket broadcast added if data changes affect frontend
- [ ] Phone numbers normalized with
kommo.NormalizePhone()if applicable
Common Mistakes to Catch
- Missing import in Go — will fail build
- Missing closing brace — often happens in large file edits
- Leftover code fragments — from copy-paste edits
- Wrong variable type in TypeScript — breaks build
- Hardcoded values that should come from config/env
- Deleted helper functions — accidentally removed during large replacements
- Missing route registration — handler exists but route not added
Related Skills
ricardoalejandro/kommo-integration
tools
VerifiedTrustedCommunity
Work with Kommo CRM integration in Clarin. Use when modifying the sync worker, API client, lead/contact/tag synchronization, or phone normalization. Covers the one-way Kommo to Clarin sync flow.
SKILL.mdUpdated Apr 15, 2026
ricardoalejandro/frontend-development
development
VerifiedTrustedCommunity
Create beautiful, polished, and highly usable Next.js/React/TypeScript interfaces for Clarin CRM. Use when creating or modifying dashboard pages, components, API calls, WebSocket listeners, or UI styling. Enforces visual excellence, micro-interactions, accessibility, and the emerald/slate design system.
SKILL.mdUpdated Apr 15, 2026
ricardoalejandro/database-changes
development
VerifiedTrustedCommunity
Make database schema changes for Clarin CRM. Use when adding tables, columns, indexes, or modifying the PostgreSQL schema. Migrations live in database.go InitDB() function.
SKILL.mdUpdated Apr 15, 2026
ricardoalejandro/build-and-deploy
development
VerifiedTrustedCommunity
Build, deploy, and verify changes for Clarin CRM. Use this skill after making any code change to compile, deploy, and validate that everything works correctly. Covers Docker-based builds for Go backend and Next.js frontend.
SKILL.mdUpdated Apr 15, 2026