shalin-rahman/skills/typescript-clean
skills/typescript-clean/SKILL.md
# Skill: TypeScript Clean Code (Staff Engineer) # Usage: Use for any TypeScript-based project to ensure enterprise-grade type safety and readability. ## Core Rules: - **Strict Typing:** Never use `any`. Use `unknown` with type guards if the type is truly uncertain. - **Interfaces vs Types:** Use `interface` for public APIs (extendability) and `type` for unions, intersections, and primitives. - **Functional Patterns:** Prioritize immutability. Use `readonly` for arrays and objects where possible
$ install --global
skillsauthnpx skillsauth add shalin-rahman/Synapticity skills/typescript-cleanInstall 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 23, 2026, 12:57 AM407.4s1 file scanned
SKILL.md
Skill: TypeScript Clean Code (Staff Engineer)
Usage: Use for any TypeScript-based project to ensure enterprise-grade type safety and readability.
Core Rules:
- Strict Typing: Never use
any. Useunknownwith type guards if the type is truly uncertain. - Interfaces vs Types: Use
interfacefor public APIs (extendability) andtypefor unions, intersections, and primitives. - Functional Patterns: Prioritize immutability. Use
readonlyfor arrays and objects where possible. - Error Handling: Use custom
Errorclasses or theResultpattern (e.g.,{ success: true, data: T } | { success: false, error: E }) for predictable logic. - Naming: Use
PascalCasefor classes/interfaces,camelCasefor variables/functions, andUPPER_SNAKE_CASEfor constants.
Pattern: Discriminated Union
type ApiResponse<T> =
| { status: 'success'; data: T }
| { status: 'error'; message: string; code: number };
function handle(res: ApiResponse<User>) {
if (res.status === 'success') {
return res.data.name; // Type is narrowed
}
}
Maintenance:
- Keep functions small and single-purpose (SOLID principles).
- Use Template Literal Types for complex string configurations.
- Prefer
Record<K, V>over index signatures.
Related Skills
shalin-rahman/skills/zero-defect-engineering
tools
VerifiedTrustedCommunity
# Skill: Zero-Defect Software Engineering # Focus: Writing immortal, self-documenting, and resilient source code. ## Playbook Strategy: 1. **SOLID Foundations**: - **Single Responsibility**: Every class/function does ONE thing perfectly. - **Open/Closed**: Design for extension without modification. 2. **DRY (Don't Repeat Yourself)**: If logic appears twice, abstract it into a utility or base class. 3. **Defensive Programming**: - Validate every input. - Handle every exception specif
1SKILL.mdUpdated Apr 22, 2026
shalin-rahman/skills/testing-strategies
development
VerifiedTrustedCommunity
# Skill: Advanced Testing Strategies (TDD / BDD) # Usage: Use to enforce high code quality, prevent regressions, and ensure requirements are met implicitly. ## 🧪 The Testing Pyramid - **Unit Tests (70%)**: Fast, isolated tests for individual functions and classes. Mock all external dependencies. - **Integration Tests (20%)**: Test the interaction between several units or external systems (e.g., Database, APIs). - **End-to-End (E2E) Tests (10%)**: Slow, brittle tests that verify the system as a
1SKILL.mdUpdated Apr 22, 2026
shalin-rahman/skills/technical-writing-standards
development
VerifiedTrustedCommunity
# Skill: Technical Hand-off & Clarity # Focus: Professional documentation for human and machine consumption. ## Playbook Strategy: 1. **The "ReadMe First" Rule**: Use structured, hierarchical markdown. High-level summary first, deep-dive implementation second. 2. **Contextual Grounding**: Explain the "Why" and the "How" for every project. 3. **Semantic Clarity**: Use industry-standard terminology. Avoid jargon where simple language suffices. 4. **Machine-Readable Annotations**: Include clear co
1SKILL.mdUpdated Apr 22, 2026
shalin-rahman/skills/sqlalchemy-expert
development
VerifiedTrustedCommunity
# Skill: SQLAlchemy Expert (Performance & Safety) # Usage: Use for backend services involving SQL databases and SQLAlchemy ORM (v2.0+). ## Best Practices: - **Async Engine:** Use `AsyncSession` and `create_async_engine` for modern FastAPI backends. - **Declarative Mapping:** Use `Mapped` and `mapped_column` for modern v2.0 type hinting. - **Relationship Management:** Always specify `lazy="selectin"` for collections or `joinedload` for many-to-one to avoid N+1 query problems. - **Transaction Saf
1SKILL.mdUpdated Apr 22, 2026