# Datalad Status

> >

- **Type:** Skill
- **Install:** `agentstack add skill-neuroanalytics-data-science-harness-datalad-status`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [neuroanalytics](https://agentstack.voostack.com/s/neuroanalytics)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [neuroanalytics](https://github.com/neuroanalytics)
- **Source:** https://github.com/neuroanalytics/data-science-harness/tree/main/plugins/datalad-cli/skills/datalad-status

## Install

```sh
agentstack add skill-neuroanalytics-data-science-harness-datalad-status
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: datalad-status

Inspect the current state of a DataLad dataset — what files are modified, untracked,
added, or deleted — without making any changes.

## Steps

1. **Verify DataLad context** — check for `.datalad/` in the current directory or any
   parent:
   ```bash
   ls .datalad/ 2>/dev/null || git rev-parse --show-toplevel
   ```
   - **Dataset found**: continue.
   - **No dataset found**: inform the user and suggest `/datalad-init` or plain `git status`.

2. **Run `datalad status`** — optionally scoped to paths from `$ARGUMENTS`:
   ```bash
   datalad status [paths...]
   ```
   Present the full output to the user. Additional flags to mention if relevant:
   - `--annex` — shows verbose annex content state (number of copies, remote presence)
     for each annexed file; useful for understanding data availability
   - `--untracked=no` — suppresses untracked files from output (useful in large repos
     with many untracked directories that would otherwise clutter the output)

3. **Interpret the status symbols** — explain each symbol present in the output:

   | Symbol | Meaning |
   |--------|---------|
   | `modified` | Content changed since last save |
   | `untracked` | File exists on disk but is not recorded in the dataset |
   | `deleted` | File was tracked but is now missing from disk |
   | `added` | New file staged but not yet saved |
   | `clean` | No changes — working tree matches the last commit |

   For annexed files, also explain:
   - **content present**: file pointer exists and content is available locally
   - **content missing**: file pointer exists but content was dropped (pointer only)

4. **Suggest next actions** — based on what was found:
   - Modified or untracked files → suggest `/datalad-save`
   - Missing annex content → suggest `datalad get ` to retrieve it
   - Output files that should have been produced by a command → suggest `/datalad-run`
   - Clean working tree → confirm no action needed

## Constraints

- Read-only — never run any command that modifies the dataset, stages files, or commits.
- Always explain every status symbol that appears in the output — never show raw output
  without interpretation.
- If the user asks about a specific path, scope the status command to that path.
- Do not confuse `datalad status` (dataset state) with `git status` — they overlap but
  DataLad status correctly handles annexed files that git would misreport.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [neuroanalytics](https://github.com/neuroanalytics)
- **Source:** [neuroanalytics/data-science-harness](https://github.com/neuroanalytics/data-science-harness)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-neuroanalytics-data-science-harness-datalad-status
- Seller: https://agentstack.voostack.com/s/neuroanalytics
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
