alex-popov-tech/.dotfiles
Overview
This skill detects whether a repository uses TypeScript and identifies an available TypeScript compilation command for the quality-gates-compilation agent. It reports the presence of the root tsconfig.json, the path, and a single compile command with its source. The output is a compact JSON structure ready for automated consumption.
How this skill works
The skill first checks for a root tsconfig.json to determine whether TypeScript is configured. If found, it scans sources in priority order — CLAUDE.md, package.json scripts, Makefile — extracting an exact compile command. If no command is discovered, it supplies a safe fallback command (npx tsc --noEmit) and records the source as fallback. The final result is a structured JSON object containing detection status, config file info, and the chosen compile command with its source.
When to use it
- During Phase 0 (Environment Detection) of the quality-gates-compilation workflow
- When you need an automated agent to decide whether to run TypeScript checks
- To locate a single canonical compile command for type checking
- Only for environment detection — not for full linting or type-checking runs
- When preparing CI steps that need a reproducible command
Best practices
- Only check the root tsconfig.json; ignore project-specific configs like tsconfig.build.json
- Respect the command priority: CLAUDE.md > package.json > Makefile > fallback
- Return the first matching command from the highest-priority source and record that source verbatim
- Use the fallback npx tsc --noEmit when no explicit command is found
- Keep the returned compile string exact so agents can run it without modification
Example use cases
- Detect TypeScript in a dotfiles repository to decide whether to run type checks in CI
- Extract npm script compile commands from package.json for automated type-check runs
- Read CLAUDE.md for an explicit developer-recommended type-check command before falling back
- Locate a Makefile target like make compile and return make <target> as the compile command
- Provide a deterministic fallback command when no source defines a compile step
FAQ
The skill uses priority rules and returns only the command from the highest-priority source (CLAUDE.md, then package.json, then Makefile, then fallback).
What if tsconfig.json is missing?
The skill sets typescriptDetected to false, marks configFile.exists false, and returns an empty command object so the agent can skip TypeScript steps.
2 skills
This skill detects TypeScript configuration and available compile commands, returning a structured summary for the quality-gates-compilation agent.
This skill removes git worktrees from the .worktrees directory, cleans traces, and optionally lets you interactively select which to delete.
