scan-projects

Scan Projects Skill

Goal

Scan all valid software projects under the configured scan_root and output a Markdown report (projects-list.md) for manual filtering.

Step 0: Read config

Read profile.config.json from the current working directory. If missing, tell the user to copy examples/profile.config.example.json to profile.config.json and fill it in, then stop.

• scan_root (default ~/project if not set) — expand ~ to $HOME
• A user-specified path argument overrides scan_root for this run

Definition of a Valid Software Project

A directory is considered a valid project root if any of the following markers exist (file or directory):

package.json, Cargo.toml, go.mod, pyproject.toml, requirements.txt, setup.py,
Makefile, pom.xml, build.gradle, CMakeLists.txt, .git, composer.json, Gemfile,
Dockerfile, dockerfile, docker-compose.yml, docker-compose.yaml, compose.yml, compose.yaml

Execution Steps

Step 1: Confirm scan root directory

• Use scan_root from config (or the user-specified override)
• Verify the directory exists with ls

Step 2: Execute scan (recursive, max 4 levels)

• If the current directory matches any marker → treat as project root, do not recurse further
• If no match → continue scanning subdirectories, max depth of 4
• Skip the following subdirectory names: node_modules, .git, .venv, __pycache__, dist, build, packages

Use the following bash script:

BASE_DIR="<scan_root, ~ expanded to $HOME>"
MAX_DEPTH=4
MARKERS=(
  "package.json" "Cargo.toml" "go.mod" "pyproject.toml" "requirements.txt"
  "setup.py" "Makefile" "pom.xml" "build.gradle" "CMakeLists.txt" ".git"
  "composer.json" "Gemfile" "Dockerfile" "dockerfile"
  "docker-compose.yml" "docker-compose.yaml" "compose.yml" "compose.yaml"
)

is_project_root() {
  local dir="$1"
  for marker in "${MARKERS[@]}"; do
    [[ -e "$dir/$marker" ]] && return 0
  done
  return 1
}

collect_projects() {
  local dir="$1"
  local depth="$2"
  [[ "$depth" -gt "$MAX_DEPTH" ]] && return

  if is_project_root "$dir"; then
    echo "$dir"
    return
  fi

  while IFS= read -r subdir; do
    collect_projects "$subdir" $(( depth + 1 ))
  done < <(find "$dir" -mindepth 1 -maxdepth 1 -type d \
    ! -name "node_modules" ! -name ".git" ! -name ".venv" \
    ! -name "__pycache__" ! -name "dist" ! -name "build" ! -name "packages")
}

collect_projects "$BASE_DIR" 0