Skip to content

GravionLabs/elysion / .agents/skills/detect-techstack

detect-techstack

Unverified

Detect the project tech stack and return a JSON report with its language skills. Use before loading language skills.

Run the detection script from the project root and hand the JSON to the caller; load <lang>-test and <lang>-implementation from its test and implementation lists.

Return contract: the JSON object below and nothing else — no file listings, no reasoning. The skill runs in the caller's context (the script needs a shell, which forked read-only subagents do not reliably have).

Paths to scripts/ are relative to this skill's directory.

pwsh scripts/Detect-TechStack.ps1 -ProjectRoot .

Run it with a shell in the caller's context. Output not a JSON object with a languages array (empty output, [], prose) → rerun once; still invalid → say so and ask before guessing the stack.

Output (stdout, exit 0)

{
  "languages": ["ts", "py", "dotnet"],
  "frameworks": ["angular"],
  "packageManager": ["pnpm", "dotnet"],
  "test": ["ts-test", "py-test", "dotnet-test"],
  "implementation": ["ts-implementation", "py-implementation", "dotnet-implementation"],
  "tools": ["vitest", "biome", "cargo"],
  "governance": {
    "configured": true,
    "adrDir": "docs/adr",
    "adrCount": 12,
    "specDir": "docs/specs",
    "specCount": 3,
    "hint": null
  }
}

governance reports the ADR and spec folders: configured is true when .agents/config.json has a governance key (adrDir/specDir from it, else the default folders docs/adr and docs/specs); counts are NNNN-*.md files in adrDir and *.md files in specDir. When hint is not null, show it to the user as is.

tools is found by config files in the project root: vitest (vitest.config.*, vite.config.* with a test block, or vitest in package.json), biome (biome.json[c]), eslint (eslint.config.*, .eslintrc*), prettier (.prettierrc*, prettier.config.*), jest (jest.config.*), pytest (pytest.ini, [tool.pytest in pyproject.toml), cargo (Cargo.toml).

On failure the script exits non-zero with the error on stderr. No stack detected → all arrays empty.

Fallback without PowerShell

If pwsh is not available → infer the stack from this table (search recursively, depth 5) and build the same JSON by hand:

MarkerResult
angular.jsonframework angular, language ts
package.json + tsconfig.jsonlanguage ts; package.json alone → js
pyproject.toml, requirements.txt, setup.pylanguage py
*.csproj, *.sln, *.slnxlanguage dotnet, package manager dotnet
Cargo.tomllanguage rust (skills rust-test, rust-implementation)
go.modlanguage go (skills go-test, go-implementation), package manager go
react, next, vue, svelte in dependencies/devDependencies of any package.jsonframework of the same name (several possible; language and skills stay ts/js)
src-tauri/tauri.conf.json or .json5framework tauri (next to rust and usually ts)
Aspire.AppHost.Sdk in a *.csproj or #:sdk Aspire.AppHost.Sdk in a *.csframework aspire (next to dotnet)
docs/adr/NNNN-*.md, docs/specs/*.md, and the governance key of .agents/config.json (absent → configured false, hint when files exist)governance counts, configured, hint
packageManager field in package.json, else lockfile (pnpm-lock.yaml, yarn.lock, bun.lockb, package-lock.json, uv.lock)package manager

Gotchas

  • Monorepos report several languages (e.g. Angular frontend + .NET backend); load every listed skill.
  • A skill named in test or implementation that is not installed (stacks are installed per project): report "run /skills-manage <stack> in this project" (ts, py, dotnet, go; ng for angular, rust), never fail silently.
  • js has no js-test/js-implementation skill in this hub; treat it like ts without type rules.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall