Agent skill

Project Awareness

by jmagly in jmagly/aiwg

Detect project type, AIWG framework state, team configuration, and active work to summarize status and recommend next actions

MITAuto-check passed

Install Project Awareness

skills CLI
$ npx skills add jmagly/aiwg --skill project-awareness -a claude-code

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

GitHub CLI
$ gh skill install jmagly/aiwg project-awareness --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/jmagly/aiwg.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agentic/code/plugins/utils/skills/project-awareness .claude/skills/project-awareness && 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-awareness
GitHub stars
220
Token cost
~2.3k tokens
SKILL.md length
589 words
Files
4 (incl. scripts, references)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Detect project type, AIWG framework state, team configuration, and active work to summarize status and recommend next actions

  • Works in 5 steps: Detects project type → Identifies AIWG state → Parses team configuration → …
  • SKILL.md covers Triggers, Purpose, Behavior and Trigger Phrase Mappings, plus 11 more sections
  • Runs Python scripts from its folder; calls python

What it does

Project Awareness is an agent skill from jmagly/aiwg. Detect project type, AIWG framework state, team configuration, and active work to summarize status and recommend next actions

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/phase-guide.md`, `scripts/project_awareness.py` and `scripts/status_check.py`).

The repository describes itself as: Cognitive architecture for AI-augmented software development. Specialized agents, structured workflows, and multi-platform deployment. Claude Code · Codex · Copilot · Cursor ·… The licence is MIT.

Example prompts

  • “/project-awareness”

Requirements

  • Python 3
  • Node.js

Workflow steps

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

  1. Detects project type
  2. Identifies AIWG state
  3. Parses team configuration
  4. Loads recent activity
  5. Builds context object

What it can do on your machine

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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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 Awareness loads about 2.3k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 36 tokens; SKILL.md has 589 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from jmagly/aiwg at commit dda238f, republished under its MIT licence (© jmagly). 589 words, ~2,286 tokens.

Download SKILL.mdSave it as .claude/skills/project-awareness/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
project-awareness
description
Detect project type, AIWG framework state, team configuration, and active work to summarize status and recommend next actions
namespace
aiwg
platforms
all

project-awareness

Comprehensive project context detection and state awareness.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

  • "where are we" / "what's next" → project state summary
  • "what's blocking" in project context → status + blockers
  • "sprint status" → iteration awareness

Purpose

This skill provides rich project context awareness including:

  • Project type and technology stack detection
  • AIWG framework state (installed frameworks, current phase)
  • Team configuration and agent assignments
  • Recent activity and artifact status
  • Active work detection (branches, PRs, iterations)
  • Recommendations for next actions

Behavior

When triggered, this skill:

  1. Detects project type:

    • Monorepo vs single project
    • Library vs application vs service
    • Web, API, CLI, mobile, etc.
    • Programming languages and frameworks
  2. Identifies AIWG state:

    • Installed frameworks (SDLC, MMK, addons)
    • Current lifecycle phase
    • Active iteration (if applicable)
    • Deployed agents and commands
  3. Parses team configuration:

    • Team roster from .aiwg/team/
    • Agent assignments
    • Role responsibilities
  4. Loads recent activity:

    • Git log (recent commits, active branches)
    • Recent artifact changes
    • Open PRs and issues
  5. Builds context object:

    • Structured data for other skills
    • Summary for user display
    • Recommendations for next actions

Trigger Phrase Mappings

Natural LanguageAction
"Where are we?"Check phase status, recent activity
"What's next?"Identify pending tasks, next milestone
"Project status"Full status report
"Current phase"Phase name + completion percentage
"Ready to transition?"Gate criteria check
"What's blocking us?"Risk register + blockers
"How long until..."Milestone progress estimate
"Who owns..."Team and agent assignments

Information Sources

Primary Sources (Check First)
  • .aiwg/planning/phase-status.md - Current phase and progress
  • .aiwg/planning/iteration-plan.md - Current iteration tasks
  • .aiwg/gates/ - Gate criteria and validation status
Secondary Sources
  • .aiwg/risks/risk-register.md - Active risks and blockers
  • .aiwg/team/agent-assignments.md - Who's working on what
  • .aiwg/requirements/ - Requirements completion status
  • .aiwg/architecture/ - Architecture baseline status
Context Sources
  • CLAUDE.md - Project configuration
  • .aiwg/intake/project-intake.md - Original project scope
  • Git log - Recent activity

Context Object Structure

json
{
  "project": {
    "name": "my-project",
    "type": "application",
    "subtype": "web-api",
    "root": "/path/to/project",
    "description": "From package.json or README"
  },

  "tech_stack": {
    "languages": ["typescript", "python"],
    "runtime": "node",
    "framework": "express",
    "package_manager": "npm",
    "database": "postgresql",
    "testing": "vitest",
    "ci_cd": "github-actions"
  },

  "aiwg": {
    "installed": true,
    "frameworks": ["sdlc-complete"],
    "addons": ["aiwg-utils", "voice-framework"],
    "phase": "elaboration",
    "iteration": 3,
    "agents_deployed": 45,
    "commands_deployed": 38
  },

  "team": {
    "members": [
      {"name": "John", "role": "tech-lead", "agent": "architecture-designer"}
    ],
    "agent_assignments": {
      "architecture-designer": "John",
      "test-architect": "Jane"
    }
  },

  "activity": {
    "current_branch": "feature/user-auth",
    "recent_commits": [...],
    "open_prs": [...],
    "modified_artifacts": [...],
    "last_gate_check": "2025-12-05"
  },

  "artifacts": {
    "total": 24,
    "by_status": {
      "draft": 5,
      "review": 3,
      "baselined": 16
    },
    "recent": [...]
  },

  "recommendations": [
    "Complete SAD review (2 reviewers pending)",
    "Run gate-check for Elaboration exit",
    "Update risk register (7 days stale)"
  ]
}

Response Formats

Quick Status (Default)
Phase: [Current Phase] ([X]% complete)
Iteration: [N] of [Total]
Next Milestone: [Milestone Name] - [Date/Status]
Blockers: [Count] ([List if < 3])
Full Status (On Request)
## Project: [Name]
Phase: [Phase] | Iteration: [N]
Started: [Date] | Target: [Date]

### Completion
- Requirements: [X]%
- Architecture: [X]%
- Implementation: [X]%
- Testing: [X]%

### Active Work
- [Task 1] - [Owner] - [Status]
- [Task 2] - [Owner] - [Status]

### Blockers/Risks
- [Risk 1] - [Severity] - [Mitigation]

### Next Steps
1. [Action 1]
2. [Action 2]

Detection Methods

Project Type Detection
IndicatorProject Type
package.json + src/index.tsNode.js application
package.json + lib/Node.js library
setup.py or pyproject.tomlPython package
Cargo.tomlRust project
go.modGo module
pom.xmlJava Maven project
turbo.json or lerna.jsonMonorepo
Framework Stack Detection
FilesFramework
next.config.jsNext.js
angular.jsonAngular
vite.config.tsVite
django, manage.pyDjango
express in package.jsonExpress
fastapi in requirementsFastAPI
Show full SKILL.md (233 more words)Show less
AIWG State Detection
LocationInformation
.aiwg/AIWG artifacts directory exists
.aiwg/config/registry.jsonInstalled frameworks
.aiwg/planning/phase-plan-*.mdCurrent phase
.aiwg/planning/iteration-*.mdCurrent iteration
.claude/agents/Deployed agents
.claude/commands/Deployed commands
Phase Detection Heuristics
Artifacts PresentLikely Phase
intake/ onlyConcept/Inception
requirements/ + architecture/ draftInception
architecture/ baselinedElaboration
testing/ + deployment/ draftConstruction
deployment/ baselinedTransition
All baselined + production logsProduction

Phase Reference

PhaseDescriptionKey Artifacts
InceptionVision, risks, feasibilityintake forms, business case
ElaborationArchitecture baselineSAD, ADRs, test strategy
ConstructionFeature implementationcode, tests, reviews
TransitionDeployment, handoverrunbooks, training
ProductionOperations, iterationmonitoring, incidents

Command Bindings

This skill may trigger these commands based on context:

ContextCommand
User wants full report/project-status
User asks about health/project-health-check
User asks about gate readiness/flow-gate-check [phase]
User seems lost on next stepsSuggest relevant flow command

Usage Examples

Session Start Context
Model auto-invokes project-awareness

Returns:
"Project: MyAPI (Node.js/Express API)
Phase: Elaboration (Iteration 3)
Team: 4 members assigned
Recent: SAD approved, Test Plan in review

Recommendations:
- Complete Test Plan review
- Begin Construction planning"
Explicit Query
User: "What phase are we in?"

Skill returns:
"Current Phase: Elaboration
Milestone: Architecture Baseline (ABM)
Progress: 75% complete

Completed:
✓ Requirements baseline
✓ SAD approved
✓ 3/5 ADRs written

Remaining:
- Test Plan approval
- Risk register update
- Gate check"
Team Query
User: "Who owns the architecture?"

Skill returns:
"Architecture ownership:
- Lead: John (architecture-designer)
- Reviewers: Jane (security-architect), Bob (test-architect)

Recent activity:
- SAD v1.2 updated 2 days ago
- ADR-005 created yesterday"

CLI Usage

bash
# Full context dump
python project_awareness.py --full

# Specific aspects
python project_awareness.py --tech-stack
python project_awareness.py --aiwg-state
python project_awareness.py --team
python project_awareness.py --activity

# JSON output
python project_awareness.py --full --json

# Recommendations only
python project_awareness.py --recommendations

Integration

This skill provides context for:

  • artifact-orchestration: Knows current phase for artifact selection
  • gate-evaluation: Knows what gate to check
  • parallel-dispatch: Knows which agents are relevant
  • template-engine: Knows project name, type for templates
  • All SDLC flows: Phase and iteration context
  • All other skills that need project context

Caching

Context is cached for performance:

  • Tech stack: Cached until package files change
  • AIWG state: Cached for 5 minutes
  • Activity: Refreshed on each call
  • Team: Cached until team files change

Cache location: .aiwg/working/context-cache.json

References

  • Team configuration: .aiwg/team/
  • Phase plans: .aiwg/planning/
  • Registry: .aiwg/config/registry.json
  • Artifact index: .aiwg/reports/artifact-index.json

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

Files

SKILL.md and 3 other files (scripts, references) in agentic/code/plugins/utils/skills/project-awareness of jmagly/aiwg.

  • SKILL.md
  • references/phase-guide.md
  • scripts/project_awareness.py
  • scripts/status_check.py

Open the folder on GitHubat commit dda238f

Compare with similar skills

Project Awareness 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 Awareness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Awareness this skilljmagly/aiwg220—~2.3kAutomated safety check: PassMIT
Threat Detectionalirezarezvani/claude-skills28k—~3.5kAutomated safety check: PassMIT
Resemble Detectgithub/awesome-copilot40k3 repos~4.1kAutomated safety check: PassApache-2.0
Pii Detectruvnet/ruflo74k—~350Automated safety check: NotesMIT
Detecting Dnp3 Protocol Anomaliesmukul975/Anthropic-Cybersecurity-Skills34k—~3.6kAutomated safety check: PassApache-2.0
Detecting Attacks On Scada Systemsmukul975/Anthropic-Cybersecurity-Skills34k—~6.9kAutomated safety check: PassApache-2.0

Similar skills

  • Threat Detection

    alirezarezvani/claude-skills

    A skill your agent uses when hunting for threats in an environment, analyzing IOCs, or detecting behavioral anomalies in telemetry.

    28k GitHub stars~3.5k tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • Resemble Detect

    github/awesome-copilot

    Official

    Deepfake detection and media safety — detect AI-generated audio, images, video, and text, trace synthesis sources, apply watermarks, verify speaker identity, and analyze media intelligence using…

    40k GitHub starsUsed in 3 repos~4.1k tokens
    Media & CreativeAuto-check passed
  • Pii Detect

    ruvnet/ruflo

    Detect and flag personally identifiable information (PII) in text, code, and configurations.

    74k GitHub stars~350 tokensUpdated today
    Auto-check: notes
  • Detecting Dnp3 Protocol Anomalies

    mukul975/Anthropic-Cybersecurity-Skills

    Detect anomalies in DNP3 communications used in SCADA/ICS systems by monitoring unauthorized control commands, firmware update attempts, protocol violations, and deviations from baseline traffic…

    34k GitHub stars~3.6k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Detecting Attacks On Scada Systems

    mukul975/Anthropic-Cybersecurity-Skills

    This skill covers detecting cyber attacks targeting Supervisory Control and Data Acquisition (SCADA) systems including man-in-the-middle attacks on industrial protocols, unauthorized command…

    34k GitHub stars~6.9k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Detecting AWS Cloudtrail Anomalies

    mukul975/Anthropic-Cybersecurity-Skills

    Detect unusual API call patterns in AWS CloudTrail logs using boto3, statistical baselining, and behavioral analysis to identify credential compromise, privilege escalation, and unauthorized…

    34k GitHub stars~751 tokensUpdated 1 mo ago
    SecurityAuto-check passed

More from jmagly/aiwg

All 11 skills in this repo
  • Review editorial phrase patterns and suggest contextual alternatives; legacy name does not imply authorship detection.

    220 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Voice Apply

    jmagly/aiwg

    Apply a voice profile to transform content. An agent skill from jmagly/aiwg.

    220 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Mutation Test

    jmagly/aiwg

    Run mutation testing to validate test quality beyond code coverage.

    220 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • TDD Enforce

    jmagly/aiwg

    Configure TDD enforcement via pre-commit hooks and CI coverage gates.

    220 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Manage artifact metadata, versioning, ownership, and review history across the SDLC lifecycle

    220 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Banned API Audit

    jmagly/aiwg

    Scan source code for banned APIs/forbidden functions per project banlist; report violations with paths, line numbers, and recommended replacements

    220 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Questions about Project Awareness

What does Project Awareness do?

Detect project type, AIWG framework state, team configuration, and active work to summarize status and recommend next actions. Project Awareness is an agent skill from jmagly/aiwg.

How do I install Project Awareness in Claude Code?

Run `npx skills add jmagly/aiwg --skill project-awareness -a claude-code`. Or copy the skill folder (agentic/code/plugins/utils/skills/project-awareness in jmagly/aiwg) into .claude/skills/project-awareness in your project. Claude Code loads it when a task matches its description.

How do I install Project Awareness in Codex?

Run `npx skills add jmagly/aiwg --skill project-awareness -a codex`. Or copy the skill folder (agentic/code/plugins/utils/skills/project-awareness in jmagly/aiwg) into .agents/skills/project-awareness in your project. Codex loads it when a task matches its description.

Can I use Project Awareness 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 jmagly/aiwg --skill project-awareness -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-awareness, .gemini/skills/project-awareness, .github/skills/project-awareness and .opencode/skills/project-awareness in your project.

What does Project Awareness need to run?

Going by SKILL.md and its folder, Project Awareness needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3; Node.js.

Does Project Awareness 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 Awareness 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Project Awareness use?

Project Awareness is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Awareness use?

About 2.3k tokens (SKILL.md is roughly 9.1k 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 332 tokens, read only when the agent opens those files.

What are the alternatives to Project Awareness?

Skills that share tags, products or a category with Project Awareness: Threat Detection (alirezarezvani/claude-skills, 28k stars), Resemble Detect (github/awesome-copilot, 40k stars), Pii Detect (ruvnet/ruflo, 74k stars) and Detecting Dnp3 Protocol Anomalies (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Awareness?

jmagly (a GitHub user) maintains it in jmagly/aiwg, which has 220 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

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