kayaman/language-conventions-source-en-docs-br
language-conventions-source-en-docs-br/SKILL.md
Enforces language usage conventions for teams based in Brazil. Use when writing code, documentation, docstrings, comments, configuration, or any project artifact. Brazilian Portuguese for documentation and docstrings; English for everything else (source code, identifiers, parameters, class names, function names, settings, configuration keys, commit messages, PR descriptions).
$ install --global
skillsauthnpx skillsauth add kayaman/skills language-conventions-source-en-docs-brInstall 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 22, 2026, 7:11 PM53.9s1 file scanned
SKILL.md
- name:
- language-conventions-source-en-docs-br
- description:
- Enforces language usage conventions for teams based in Brazil. Use when writing code, documentation, docstrings, comments, configuration, or any project artifact. Brazilian Portuguese for documentation and docstrings; English for everything else (source code, identifiers, parameters, class names, function names, settings, configuration keys, commit messages, PR descriptions).
Language Conventions
Rule
| Artifact | Language | | ----------------------------------------------------------------- | -------------------- | | Docstrings | Brazilian Portuguese | | Project/user-facing documentation (product README, user guides, markdown docs) | Brazilian Portuguese | | Inline comments explaining intent | Brazilian Portuguese | | Source code (identifiers, variables, functions, classes, modules) | English | | Parameters and arguments | English | | Settings / configuration keys | English | | Exception messages (runtime) | English | | Log messages | English | | Test names and assertions | English | | Commit messages and PR descriptions | English |
Examples
Docstring — Brazilian Portuguese:
def submit_transcription(audio_path: str) -> str:
"""
Submete um arquivo de áudio para transcrição assíncrona.
Args:
audio_path: Caminho do arquivo de áudio no armazenamento blob.
Returns:
Identificador do trabalho de transcrição criado.
Raises:
TranscriptionError: Quando o serviço de fala não está disponível.
"""
Source code — English:
class TranscriptionRepository:
def find_by_status(self, status: JobStatus) -> list[TranscriptionJob]:
...
Inline comment explaining intent — Brazilian Portuguese:
# Agrupa por locutor antes de calcular métricas de sobreposição
grouped = group_by_speaker(segments)
Settings — English:
MAX_RETRY_ATTEMPTS = 3
BLOB_CONTAINER_NAME = "audio-uploads"
Checklist
When writing any file, verify:
- [ ] All docstrings are written in Brazilian Portuguese
- [ ] Project/user-facing documentation (product README, user guides, markdown docs) is written in Brazilian Portuguese
- [ ] All identifiers (variables, functions, classes, modules) are English
- [ ] Parameter names and type annotations are English
- [ ] Configuration keys and environment variable names are English
- [ ] Inline comments that explain non-obvious intent use Brazilian Portuguese
- [ ] Log messages and exception strings are English
Related Skills
kayaman/data-visualization-guide
tools
VerifiedTrustedCommunity
Guidance for designing charts, graphs, plots, dashboards, and data visualizations that communicate clearly and persuade. Use when creating or reviewing a visualization, choosing a chart type, picking a color palette, decluttering a busy graphic, fixing misleading axes or proportions, building a dashboard, annotating a figure, or turning data into a presentation, report, or data-driven story. Grounded in the standard data-visualization literature (Knaflic, Tufte, Cleveland & McGill, Cairo, Wilke, Munzner, Few, Berinato). Covers chart selection, graphical perception and encoding, color and accessibility, decluttering, graphical integrity, dashboards, and narrative. Does NOT cover building data pipelines or ETL, statistical modeling or analysis methods, BI tool/vendor selection, or general UI/UX layout (see ux-design-principles). Tool-agnostic, with optional Python recipes.
1SKILL.mdUpdated May 26, 2026
kayaman/microservices-skill
development
VerifiedTrustedCommunity
Architect and implement production-grade microservices systems in TypeScript (NestJS) and Python (FastAPI), including resilience, observability, testing, deployment, and migration guidance.
1SKILL.mdUpdated May 11, 2026
kayaman/databricks-genie-spaces-best-practices
development
VerifiedTrustedCommunity
--- name: databricks-genie-spaces-best-practices description: Design, configure, curate, govern, monitor, and integrate Databricks AI/BI Genie Spaces — the natural-language-to-SQL surface over Unity Catalog. Covers space scoping, general instructions, parameterized example SQL, SQL functions, trusted assets, JOIN configuration, knowledge store, certified queries, benchmarks, monitoring tab, feedback loops, the Genie Conversation API, governance via Unity Catalog (row filters, column masks, embed
1SKILL.mdUpdated May 11, 2026
kayaman/ts-otp-aws
tools
VerifiedTrustedCommunity
Implement OTP and passwordless authentication on AWS for TypeScript projects using Cognito CUSTOM_AUTH triggers (default) or a custom DynamoDB-backed flow, with SES (email) and SNS (SMS) delivery. Use when the user mentions OTP, one-time password, passwordless login, magic link, Cognito custom auth, DefineAuthChallenge, CreateAuthChallenge, VerifyAuthChallengeResponse, SES verification email, SNS SMS code, or MFA over email/SMS. Covers architecture decision (Cognito vs custom), Lambda trigger handlers, SES/SNS notifiers, DynamoDB schema with TTL, rate limiting, constant-time comparison, threat model (enumeration, replay, brute force), and aws-sdk-client-mock testing.
1SKILL.mdUpdated May 8, 2026