Official agent skill

Directory Management

by awslabs in awslabs/agent-plugins

Manages project directory setup and artifact organization. An agent skill from awslabs/agent-plugins.

OfficialApache-2.0Auto-check passedAgent Workflows

Install Directory Management

skills CLI
$ npx skills add awslabs/agent-plugins --skill directory-management -a claude-code

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

GitHub CLI
$ gh skill install awslabs/agent-plugins directory-management --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/awslabs/agent-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/sagemaker-ai/skills/directory-management .claude/skills/directory-management && 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
directory-management
GitHub stars
915
Token cost
~426 tokens
SKILL.md length
130 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Manages project directory setup and artifact organization. An agent skill from awslabs/agent-plugins.

  • Works in 3 steps: If the project name is already known… → Otherwise, scan for existing */PLAN.md… → If no existing projects are found,…
  • Starting a new project
  • SKILL.md covers Project Setup and Directory Structure
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Directory Management is an agent skill from awslabs/agent-plugins, published by the product's own GitHub organization. Manages project directory setup and artifact organization. Use when starting a new project, resuming an existing one, or when a PLAN.md needs to be associated with a project directory. Creates the project folder structure (specs/, scripts/, notebooks/, manifests/, agentmemory/) and resolves project naming.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent memory and File organization. The repository describes itself as: Agent Plugins for AWS equip AI coding agents with the skills to help you architect, deploy, and operate on AWS. The licence is Apache-2.0.

When your agent uses it

  • Starting a new project
  • Resuming an existing one
  • A PLAN.md needs to be associated with a project directory

Example prompts

  • “Use the directory-management skill to manage project directory setup and artifact organization. An agent skill from awslabs/agent-plugins”
  • “/directory-management”

Requirements

  • Python 3

Workflow steps

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

  1. If the project name is already known from conversation context, use it.
  2. Otherwise, scan for existing */PLAN.md files in the current directory. If found, ask the user if they are resuming an existing project and…
  3. If no existing projects are found, recommend a ≤64-char lowercase slug based on what you know from the conversation (only [a-z0-9-]), or…

What it can do on your machine

Read from SKILL.md and the folder at commit da51970. 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

Directory Management loads about 426 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 130 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~426

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

The full file from awslabs/agent-plugins at commit da51970, republished under its Apache-2.0 licence (© awslabs). 130 words, ~426 tokens.

Download SKILL.mdSave it as .claude/skills/directory-management/SKILL.md (or your agent's skills folder).
name
directory-management
description
Manages project directory setup and artifact organization. Use when starting a new project, resuming an existing one, or when a PLAN.md needs to be associated with a project directory. Creates the project folder structure (specs/, scripts/, notebooks/, manifests/, agent_memory/) and resolves project naming.
metadata.version
1.0.0

Directory Management

Project Setup

Before any work begins, resolve the project name:

  1. If the project name is already known from conversation context, use it.
  2. Otherwise, scan for existing */PLAN.md files in the current directory. If found, ask the user if they are resuming an existing project and load that PLAN.md into context.
  3. If no existing projects are found, recommend a ≤64-char lowercase slug based on what you know from the conversation (only [a-z0-9-]), or ask directly if there isn't enough context. Present the recommended name and wait for user confirmation.

Once project name is resolved:

  1. Create and/or use the <experiment-name>/ directory using the confirmed name for storing all the artifacts

Directory Structure

When working with the agent, all generated files are organized under an project directory.

<project-name>/
├── specs/  
│   ├── PLAN.md             # Your customization plan
├── scripts/                # Generated Python scripts
│   ├── <project-name>_transform_fn.py
├── notebooks/              # Generated Jupyter notebooks
│   ├── <project-name>.ipynb
├── manifests/              # Machine-readable outputs (JSON)
└── agent_memory/           # Session persistence (git-ignored)
    └── session-notes.md    # Progress, artifacts, next steps

© awslabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/sagemaker-ai/skills/directory-management of awslabs/agent-plugins.

Open the folder on GitHubat commit da51970

Compare with similar skills

Directory Management 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.

Directory Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Directory Management this skillawslabs/agent-plugins915—~426Automated safety check: PassApache-2.0
Project ButlerJamesShi96/project-butler374—~3.9kAutomated safety check: PassMIT
Hipocampus Corekevin-hs-sohn/hipocampus210—~1.8kAutomated safety check: PassMIT
Hipocampus Corekevin-hs-sohn/hipocampus210—~2.6kAutomated safety check: PassMIT
Hipocampus Corekevin-hs-sohn/hipocampus210—~1.5kAutomated safety check: PassMIT
Hipocampus Corekevin-hs-sohn/hipocampus210—~1.7kAutomated safety check: PassMIT

Similar skills

  • Project Butler

    JamesShi96/project-butler

    Project memory workflow for init/upgrade, profile-aware setup, end session, normal/full close, file organization, document archiving, language switching, versioned update logs, rule review, status…

    374 GitHub stars~3.9k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Hipocampus Core

    kevin-hs-sohn/hipocampus

    3-tier agent memory system with 5-level compaction tree. An agent skill from kevin-hs-sohn/hipocampus.

    210 GitHub stars~1.8k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Hipocampus Core

    kevin-hs-sohn/hipocampus

    3-tier agent memory system with 5-level compaction tree. An agent skill from kevin-hs-sohn/hipocampus.

    210 GitHub stars~2.6k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Hipocampus Core

    kevin-hs-sohn/hipocampus

    3-tier agent memory system with 5-level compaction tree. An agent skill from kevin-hs-sohn/hipocampus.

    210 GitHub stars~1.5k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Hipocampus Core

    kevin-hs-sohn/hipocampus

    3-tier agent memory system with 5-level compaction tree. An agent skill from kevin-hs-sohn/hipocampus.

    210 GitHub stars~1.7k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Memory Md Management

    giuseppe-trisciuoglio/developer-kit

    Provides comprehensive memory file management capabilities including auditing, quality assessment, and targeted improvements for files such as CLAUDE.md.

    356 GitHub stars~2.4k tokensUpdated 29 days ago
    Agent WorkflowsAuto-check: notes

More from awslabs/agent-plugins

All 33 skills in this repo
  • Dataset Evaluation

    awslabs/agent-plugins

    Official

    Validates dataset formatting and quality for SageMaker model fine-tuning (SFT, DPO, or RLVR).

    915 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Dataset Transformation

    awslabs/agent-plugins

    Official

    Generates code that transforms datasets between ML schemas for model training or evaluation.

    915 GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed
  • AWS Lambda Managed Instances

    awslabs/agent-plugins

    Official

    Evaluate, configure, and migrate workloads to AWS Lambda Managed Instances (LMI).

    915 GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Finetuning Technique

    awslabs/agent-plugins

    Official

    Selects a fine-tuning technique (SFT, DPO, RLVR, or RLAIF) for the user's use case and validates it against the selected model's available recipes.

    915 GitHub stars~604 tokensUpdated today
    Auto-check passed
  • Hyperpod Issue Report

    awslabs/agent-plugins

    Official

    Generate comprehensive issue reports from HyperPod clusters (EKS and Slurm) by collecting diagnostic logs and configurations for troubleshooting and AWS Support cases.

    915 GitHub stars~890 tokensUpdated today
    Auto-check passed
  • Hyperpod Performance Debugger

    awslabs/agent-plugins

    Official

    Diagnose performance issues on Amazon SageMaker HyperPod clusters — uneven NCCL bandwidth across nodes and poor filesystem throughput.

    915 GitHub stars~4.1k tokensUpdated today
    Auto-check passed

Categories

Questions about Directory Management

What does Directory Management do?

Manages project directory setup and artifact organization. An agent skill from awslabs/agent-plugins. Directory Management is an agent skill from awslabs/agent-plugins, published by the product's own GitHub organization. Manages project directory setup and artifact organization.

When should I use Directory Management?

Directory Management fits situations like: starting a new project; resuming an existing one; A PLAN.md needs to be associated with a project directory.

How do I install Directory Management in Claude Code?

Run `npx skills add awslabs/agent-plugins --skill directory-management -a claude-code`. Or copy the skill folder (plugins/sagemaker-ai/skills/directory-management in awslabs/agent-plugins) into .claude/skills/directory-management in your project. Claude Code loads it when a task matches its description.

How do I install Directory Management in Codex?

Run `npx skills add awslabs/agent-plugins --skill directory-management -a codex`. Or copy the skill folder (plugins/sagemaker-ai/skills/directory-management in awslabs/agent-plugins) into .agents/skills/directory-management in your project. Codex loads it when a task matches its description.

Can I use Directory Management 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 awslabs/agent-plugins --skill directory-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/directory-management, .gemini/skills/directory-management, .github/skills/directory-management and .opencode/skills/directory-management in your project.

What does Directory Management need to run?

SKILL.md names no scripts, command-line tools or credentials: Directory Management is instructions for the agent only. Our summary lists: Python 3.

Does Directory Management 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 Directory Management 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 Directory Management use?

Directory Management is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Directory Management use?

About 426 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Directory Management?

Skills that share tags, products or a category with Directory Management: Project Butler (JamesShi96/project-butler, 374 stars), Hipocampus Core (kevin-hs-sohn/hipocampus, 210 stars), Hipocampus Core (kevin-hs-sohn/hipocampus, 210 stars) and Hipocampus Core (kevin-hs-sohn/hipocampus, 210 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Directory Management?

awslabs (a GitHub organization, an official publisher) maintains it in awslabs/agent-plugins, which has 915 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 8, 2026.

Source: awslabs/agent-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.