learn-project

A project-onboarding skill that reads key files and records a concise map of the codebase in project memory. It looks at configuration, documentation, directory structure, recent commits, and continuous-integration files.

In plain words
What is it for?
Learning a project's framework, dependencies, scripts, architecture, coding settings, development history, and deployment or test setup.
Why use it?
It gives a new agent useful project context early, so it does not have to rediscover the same architecture and setup details over many sessions.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fozikio/cortex-engine/learn-project
Any agent
npx skills add Fozikio/cortex-engine --skill learn-project
Clone the repo
git clone --depth 1 https://github.com/Fozikio/cortex-engine

Made for: Claude Code, Codex.

Per session 21 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 527 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00021 $0.00527
Opus 5 $0.00010 $0.00264
Sonnet 5 $0.00004 $0.00105
Haiku 4.5 $0.00002 $0.00053

Measured yesterday against content hash ab88d4400ba6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

learn-project scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/learn-project/SKILL.md · 58 lines

What it actually says

Learn Project

Quickly populate your agent's project memory by reading the codebase.

When to use

Run this when cortex is new and you want the agent to understand your project without waiting for it to learn organically over several sessions.

What it does

Read these files (skip any that don't exist):

  1. package.json — framework, key dependencies, scripts, project name
  2. README.md — stated purpose, setup instructions
  3. tsconfig.json / jsconfig.json — language config, strict mode
  4. Directory structure (1 level deep) — architecture shape
  5. Config files — .eslintrc, prettier, vite/next/webpack config
  6. Last 10 git commits — current momentum, commit style
  7. CI config — .github/workflows, Dockerfile, deploy scripts

How to observe

For each file read, extract 1-3 key facts. Observe into the project namespace:

observe("Next.js 14 app with App Router, TypeScript strict mode", namespace: "project")
observe("Tests in __tests__/ using vitest, coverage threshold 80%", namespace: "project")
observe("Monorepo: packages/api (Hono) and packages/web (Next.js), shared types in packages/shared", namespace: "project")

Rules

  • 8-15 observations max. This is a first impression, not a full audit.
  • Architectural facts only. "Uses React" matters. "Has 847 files" doesn't.
  • Skip dependency lists. Don't observe every package.json dependency.
  • Skip generated files. Lock files, dist/, node_modules/ tell you nothing useful.
  • Ask: would my future self search for this? If not, don't store it.

After scanning

Show the user what you learned in a brief summary:

"Got it — Next.js 14 app with Drizzle ORM, deployed to Vercel, monorepo with packages/api and packages/web. Tests use vitest. I'll pick up patterns as we work together."

If anything is wrong, the user corrects it. Corrections are high-signal — observe those too.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 58 lines · 21 tokens per session scan A ab88d4400ba6

Subscribe to this mod's changes

learn-project is a skill published in the GitHub repository Fozikio/cortex-engine (49 stars, last pushed 13d ago), licensed MIT. It adds 21 tokens to every session and 527 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

graph-mutation-plan

Cookbook for composing an applygraphmutations plan — stable entitykey patterns, the canonical label/edge vocabulary, evidence/invalidation/confidence discipline, and a worked example. Load this when building a non-trivial mutation plan.

potpie-ai/potpie · 51 tokens

potpie-infra-architecture

Use for project infra and architecture context: environments, adapters, runtime configuration, deployments, service dependencies, datastores, API contracts, ownership, incidents, and dependency blast radius.

potpie-ai/potpie · 43 tokens

alfworld-search-pattern-executor

Systematically searches a sequence of likely locations for a target object based on common sense. Use when you need to find a specific object and know which receptacles to check but not which one contains it. Takes a list of candidate receptacles, orchestrates navigation and inspection, and outputs when the target is…

zjunlp/SkillNet · 74 tokens

scienceworld-growth-focuser

Use when you have planted a seed or need to track a plant's growth stage (sprouting, flowering, reproduction). Applies the 'focus on' action to a specific plant or biological entity to signal intent and monitor its development. Trigger after planting or when you need to observe life cycle progression in the…

zjunlp/SkillNet · 71 tokens

scienceworld-conditional-box-placer

Moves an object to one of two destination containers based on a numeric threshold check. Trigger after a measurement (e.g., temperature) is taken. Place object in 'green' box if value > threshold, or 'blue' box if value < threshold.

zjunlp/SkillNet · 59 tokens

autograph

Schema-as-code enforcement for any Obsidian vault. Zero hardcoded domains. Use when creating vault cards, checking vault health, running schema compliance, deduplicating entities, generating MOC indexes, running decay cycles, bootstrapping a vault, fixing wikilinks, finding orphans or backlinks, extracting entities…

smixs/agent-second-brain · 89 tokens