harness-project-intake

Analyzes project repositories and generates structured project cards covering tech stack and architecture.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/zhengguangli/harness-engineering-kit --skill harness-project-intake-zhengguangli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-project-intake
Source: https://github.com/zhengguangli/harness-engineering-kit/tree/main/skills/harness-project-intake
Command: npx skills add https://github.com/zhengguangli/harness-engineering-kit --skill harness-project-intake-zhengguangli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When entering an unfamiliar codebase, developers waste time manually reading READMEs, package manifests, and directory trees just to understand what a project is and how to run it. This Skill automates that reconnaissance and delivers a single structured project card instead of raw file dumps. ## Core Features & Use Cases - Cost-progressive collection: Gathers information in a 6-step order (ls → package manifest → README → directory skeleton → git log → rg scan), stopping as soon as enough data exists to produce the card. - Structured project card output: Covers identity, tech stack (language, framework, runtime, package manager, deployment target), directory skeleton, key modules, build/run commands, recent activity, and known constraints. - Edge-case handling: Supports monorepos, microservices, CLI tools, missing manifests, lockfile-only projects, and outdated READMEs with explicit "Not found" or "Inferred" annotations instead of guesses. - Use Case: You clone a Go monorepo and ask "what is this project?" — the Skill detects sub-package manifests, runs tiered collection, and outputs a root overview card plus per-sub-package tech stack cards. ## Quick Start Ask the assistant to analyze the current project and produce a project overview card with its tech stack and architecture.

Frequently Asked Questions about harness-project-intake

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a quick overview of an unfamiliar codebase?▼

Run a project intake analysis that reads the package manifest, README, directory skeleton, and git history, then outputs a structured card. It summarizes the tech stack, key modules, build commands, and recent activity in one view.

How to detect a project's tech stack automatically?▼

Tech stack detection reads package manifests like package.json, Cargo.toml, go.mod, or pyproject.toml to identify language, framework, runtime, and package manager. Lockfiles and config files reveal the package manager and deployment target.

Can project analysis handle monorepos with multiple languages?▼

Yes. Monorepos are detected via sub-package directories like packages/, apps/, or services/, and each sub-package gets its own manifest detection. The output is a tiered card with a root overview plus per-sub-package tech stack matrices.

What happens when a project has no package.json or README?▼

The analysis falls back to observing file extensions with ls to infer the language, and checks for Makefile, Justfile, or Dockerfile for build hints. Affected dimensions are annotated as "Inferred (no package manifest)" rather than guessed.

Does project intake analysis modify any files?▼

No. The analysis is strictly read-only, using commands like ls, cat, find, git log, and rg. It never writes files, installs packages, or runs build commands, and the card is output only in the conversation.