Agent skill

Project Scan

by doccker in doccker/cc-use-exp

扫描当前仓库并生成或更新项目级 AGENTS.md / README.md / 全套脚手架文件(restart.sh、ignore、Dockerfile、docker-compose),适用于显式 project-scan、项目认知初始化或刷新项目级 Codex 上下文的场景。

Custom licenceAuto-check passedDevOps & Cloud

Install Project Scan

skills CLI
$ npx skills add doccker/cc-use-exp --skill project-scan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install doccker/cc-use-exp project-scan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/doccker/cc-use-exp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/cc-project-scan .claude/skills/project-scan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-scan
GitHub stars
1.1k
Token cost
~707 tokens
SKILL.md length
174 words
Files
7 (incl. references)
Skills in repo
67
Repo updated
First seen
Licence
Custom licence

At a glance

扫描当前仓库并生成或更新项目级 AGENTS.md / README.md / 全套脚手架文件(restart.sh、ignore、Dockerfile、docker-compose),适用于显式 project-scan、项目认知初始化或刷新项目级 Codex 上下文的场景。

  • Works in 9 steps: 先扫描仓库中的关键信号文件和目录,区分"明确识别"的事实与"基于结构的推断"。 → 默认确保项目级… → 读取根目录现有… → …
  • Tasks that involve Containers
  • SKILL.md covers 必须生成的文件清单, 核心方式, 协作约束 and 输出要求, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Scan is an agent skill from doccker/cc-use-exp. 扫描当前仓库并生成或更新项目级 AGENTS.md / README.md / 全套脚手架文件(restart.sh、ignore、Dockerfile、docker-compose),适用于显式 project-scan、项目认知初始化或刷新项目级 Codex 上下文的场景。

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `agents/openai.yaml`, `references/agents-blocks.md` and `references/readme-update.md`).

It sits in DevOps & Cloud, covering Containers and Agent instruction files. It works with Docker. The repository describes itself as: ⛔ No longer maintained → dev-agent-kit/recipes 让 Claude Code、Antigravity、Gemini CLI、Codex、Cursor 开箱即用的分层配置模板,总结十多年的日常开发经验.

When your agent uses it

  • Tasks that involve Containers
  • Tasks that involve Agent instruction files

Example prompts

  • “/project-scan”

Requirements

  • Docker

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. 先扫描仓库中的关键信号文件和目录,区分"明确识别"的事实与"基于结构的推断"。
  2. 默认确保项目级 .codex/tasks/、.codex/tasks/archived/、.codex/templates/ 存在;若项目根目录写入触发权限边界,先走平台审批,不静默跳过。
  3. 读取根目录现有 AGENTS.md、README.md、.claude/CLAUDE.md,并复用 cc-project-init/assets/AGENTS.project.md 作为 AGENTS.md 模板来源。
  4. 先输出扫描摘要(含技术栈识别表 + 文件存在情况表),再追问 3-5 个关键问题:项目一句话描述、是否生成全套脚手架、已存在文件的处理策略(覆盖 / 增量 / 跳过)、Docker 暴露端口、API 契约确认。
  5. AGENTS.md / README.md 写入策略
  6. 脚手架文件写入策略(restart.sh / ignore / Dockerfile / docker-compose)
  7. restart.sh 落盘后必须 chmod +x。
  8. 模板选择规则参见 cc-project-init/references/template-selection.md;忽略文件内容规范参见 references/scaffold-files.md。
  9. 完成后输出摘要:已生成文件、已跳过文件、已补齐的 .codex 骨架,以及仍需用户补充的项目事实。

What it can do on your machine

Read from SKILL.md and the folder at commit 64470cb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Scan loads about 707 tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 174 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~707
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 174 words (~707 tokens).

“当用户明确要求 project-scan、扫描项目、生成项目级 AGENTS.md、生成或刷新 README.md,或刷新项目级 Codex 上下文时,使用本技能。”

— opening of SKILL.md by doccker, Custom licence
name
project-scan

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files (references) in .codex/skills/cc-project-scan of doccker/cc-use-exp.

  • SKILL.md
  • agents/openai.yaml
  • references/agents-blocks.md
  • references/readme-update.md
  • references/rebuild-strategy.md
  • references/scaffold-files.md
  • references/scan-checks.md

Open the folder on GitHubat commit 64470cb

Compare with similar skills

Project Scan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Scan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Scan this skilldoccker/cc-use-exp1.1k—~707Automated safety check: PassCustom licence
Iron Proxy Gateway for NanoClawnanocoai/nanoclaw31k—~4.6kAutomated safety check: NotesMIT
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0
Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit2606 repos~1.1kAutomated safety check: NotesCustom licence
LangBot Deployment Guidelangbot-app/LangBot18k—~1.2kAutomated safety check: NotesApache-2.0
Build Openshell Mxc WindowsNVIDIA/OpenShell15k—~4.9kAutomated safety check: PassApache-2.0

Similar skills

  • Installs or refreshes Iron Proxy and its Iron Control web console for NanoClaw, with a local Docker setup, database, credentials and a human approval bridge.

    31k GitHub stars~4.6k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes
  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Official

    Maintain and validate OpenShell's build-only Windows MSVC lane for x64 and ARM64.

    15k GitHub stars~4.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Omnigent Docker Compose Deploy

    omnigent-ai/omnigent

    Brings up the Omnigent server and Postgres as a Docker compose stack on any Docker host, and covers the Dockerfile's runtime and host build targets for extending it to a new platform.

    11k GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from doccker/cc-use-exp

All 67 skills in this repo
  • API Design Safety

    doccker/cc-use-exp

    当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

    1.1k GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Code Quality Principles

    doccker/cc-use-exp

    当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。

    1.1k GitHub stars~816 tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Review

    doccker/cc-use-exp

    结构化代码审查工作流,适用于显式 quick/full/security review;不负责普通实现或 bug 修复流程。

    1.1k GitHub stars~541 tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Streaming Export Safety

    doccker/cc-use-exp

    当实现用户驱动的大文件导出或批量序列化(Excel/CSV/JSON/JSONL/PDF,数据量未知或超过 1 万行/10 MB)时触发;普通小文件下载、静态资源下载、非导出 Writer/Report 类不触发。防止 OOM、临时文件残留、同步导出阻塞 HTTP 线程和表格公式注入。

    1.1k GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Code Quality Principles

    doccker/cc-use-exp

    当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。

    1.1k GitHub stars~803 tokensUpdated 1 mo ago
    Auto-check passed
  • External System Debugging

    doccker/cc-use-exp

    涉及浏览器、编辑器、CDN/WAF、IM 平台、操作系统剪贴板、第三方 SaaS 等"外部黑盒系统"的代码编写或 bug 调试时触发。强制先抓真实环境数据再推理,避免连续 2 轮"凭代码推理"的修复 no-op。关键词:粘贴/复制异常、跨平台显示不一致、第三方 API 怪结果、CDN/WAF 拦截、本地复现失败、HTML→MD 转换丢属性。

    1.1k GitHub stars~823 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Project Scan

What does Project Scan do?

扫描当前仓库并生成或更新项目级 AGENTS.md / README.md / 全套脚手架文件(restart.sh、ignore、Dockerfile、docker-compose),适用于显式 project-scan、项目认知初始化或刷新项目级 Codex 上下文的场景。. Project Scan is an agent skill from doccker/cc-use-exp.

When should I use Project Scan?

Project Scan fits situations like: tasks that involve Containers; tasks that involve Agent instruction files.

How do I install Project Scan in Claude Code?

Run `npx skills add doccker/cc-use-exp --skill project-scan -a claude-code`. Or copy the skill folder (.codex/skills/cc-project-scan in doccker/cc-use-exp) into .claude/skills/project-scan in your project. Claude Code loads it when a task matches its description.

How do I install Project Scan in Codex?

Run `npx skills add doccker/cc-use-exp --skill project-scan -a codex`. Or copy the skill folder (.codex/skills/cc-project-scan in doccker/cc-use-exp) into .agents/skills/project-scan in your project. Codex loads it when a task matches its description.

Can I use Project Scan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add doccker/cc-use-exp --skill project-scan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-scan, .gemini/skills/project-scan, .github/skills/project-scan and .opencode/skills/project-scan in your project.

What does Project Scan need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Scan is instructions for the agent only. Our summary lists: Docker.

Does Project Scan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Scan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Scan use?

Project Scan has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Project Scan use?

About 707 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Project Scan?

Skills that share tags, products or a category with Project Scan: Iron Proxy Gateway for NanoClaw (nanocoai/nanoclaw, 31k stars), GreptimeDB Dev Docker Image (GreptimeTeam/greptimedb, 6.7k stars), Senior DevOps Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars) and LangBot Deployment Guide (langbot-app/LangBot, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Scan?

doccker (a GitHub user) maintains it in doccker/cc-use-exp, which has 1,062 GitHub stars. The repository holds 67 skills in this directory. The repository was last updated on August 26, 2026.

Source: doccker/cc-use-exp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.