Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
drshailesh88 avatar

System Awareness

drshailesh88/integrated_content_os

  • 7 installs
  • 5 repo stars
  • Updated June 18, 2026
  • drshailesh88/integrated_content_os

Detect capability gaps, propose and build new skills, and keep the skill registry and context files in sync.

About

System Awareness is a meta-skill that manages all other skills by observing gaps and proposing new capabilities. A developer uses it to log unmet needs, review the skill backlog, and sync context files after skill changes.

  • Logs capability gaps and proposes new skills
  • Syncs registry and context files (CLAUDE.md, GEMINI.md, AGENTS.md)

System Awareness by the numbers

  • 7 all-time installs (skills.sh)
  • Ranked #556 of 779 Skill Development skills by installs in the Skillselion catalog
  • Data as of Jul 29, 2026 (Skillselion catalog sync)
npx skills add https://github.com/drshailesh88/integrated_content_os --skill system-awareness

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs7
repo stars★ 5
Last updatedJune 18, 2026
Repositorydrshailesh88/integrated_content_os ↗

What it does

Detect capability gaps, propose and build new skills, and keep the skill registry and context files in sync.

Files

SKILL.mdMarkdownGitHub ↗

System Awareness - The Self-Evolving Skill Manager

Meta-Skill: This skill manages all other skills. It observes gaps, proposes new capabilities, and helps the system evolve.

---

Quick Start

1. Log a Gap

python scripts/gap_logger.py "I need to analyze ECG waveforms from images"

python scripts/gap_logger.py \
  --request "Analyze ECG images for abnormalities" \
  --context "User uploaded 12-lead ECG, wanted automated interpretation" \
  --category "medical-imaging" \
  --urgency "high"

2. Analyze Gaps

python scripts/gap_analyzer.py --list      # List all gaps
python scripts/gap_analyzer.py --analyze   # Analyze patterns
python scripts/gap_analyzer.py --report    # Generate priority report

3. Build a Skill

# Propose from a logged gap
python scripts/skill_proposer.py --gap-id "gap_2024_001"

# Build from a proposal (one command does everything)
python scripts/skill_builder.py --proposal ecg-analyzer-proposal.md

# Or build directly from a gap (fast path)
python scripts/skill_builder.py --from-gap gap_xxxx

# Or build directly with name and purpose
python scripts/skill_builder.py --name "ecg-analyzer" --purpose "Analyze ECG images"

---

Gap → Skill Pipeline

1. GAP DETECTED
   └─► gap_logger.py → gap-log.json

2. GAPS ANALYZED
   └─► gap_analyzer.py → patterns, priorities

3. SKILL PROPOSED
   └─► skill_proposer.py → skill-templates/*.md

4. HUMAN REVIEW
   └─► Approve / reject / modify proposal

5. SKILL BUILT ★
   └─► skill_builder.py → skills/[category]/[name]/
       ├── Creates SKILL.md
       ├── Creates scripts/ & references/
       ├── Marks gap as resolved
       └── Archives proposal

6. SYSTEM SYNCED (auto-runs)
   └─► sync_skills.py → capability-registry.json

7. CONTEXT UPDATED (auto-runs)
   └─► generate_context.py → CLAUDE.md, GEMINI.md, AGENTS.md

8. SKILL AVAILABLE ✓
   └─► Ready to use in next conversation

Approval Checklist (Step 4)

Before approving a new skill:

  • [ ] Frequency: Is this needed often enough?
  • [ ] Impact: Does it unblock important workflows?
  • [ ] Feasibility: Can we actually build this?
  • [ ] Overlap: Does an existing skill already do this?
  • [ ] Maintenance: Can we keep this updated?

Validation & Error Recovery

After each major step, verify before proceeding:

StepVerifyIf it fails
sync_skills.py --updateCheck registry entry count increasedRe-run with --dry-run to inspect conflicts; resolve duplicate IDs manually
generate_context.py --updateConfirm AUTO-GENERATED markers are present in target filesEnsure markers exist: <!-- AUTO-GENERATED SKILLS START --> … <!-- AUTO-GENERATED SKILLS END -->
skill_builder.pyValidate new SKILL.md parses correctlyCheck frontmatter for required name/description fields; re-run builder
Registry integrityRun python scripts/registry_updater.py --statsIf count anomaly, diff against previous backup in data/backups/

---

Sync Architecture

Context files are rebuilt from a single source of truth:

skills/cardiology/*   skills/scientific/*  ...
        └──────────────────┬───────────────┘
                           ▼
                   sync_skills.py
                           ▼
             capability-registry.json
                           ▼
               generate_context.py
                           ▼
        CLAUDE.md   GEMINI.md   AGENTS.md   SKILL-CATALOG.md

Sync Commands

# Discover new skills
python scripts/sync_skills.py              # Report only (dry run)
python scripts/sync_skills.py --update     # Add to registry

# Regenerate context files
python scripts/generate_context.py --preview   # Preview changes
python scripts/generate_context.py --update    # Apply to all context files

# Full pipeline (run after adding any new skill)
python scripts/sync_skills.py --update && python scripts/generate_context.py --update

Context files must contain these markers for auto-update:

<!-- AUTO-GENERATED SKILLS START -->
... skills content here ...
<!-- AUTO-GENERATED SKILLS END -->

When to Run

  • After adding a new skill: Run full pipeline
  • Weekly maintenance: sync_skills.py to check for drift
  • Before major sessions: Ensure registry is current

---

Gap Detection (For Claude)

Log a gap whenever you encounter an inability, a missing capability, a pointer to an external tool, or repeated user frustration with the same task. When logging, note it in the response:

📋 **Gap Logged**: [brief description]
Category: [category] | Urgency: [low/medium/high]

Review gaps with: `python scripts/gap_analyzer.py --list`

For full JSON schema, proposal template format, and gap pattern examples, see:

  • references/json-schemas.md — gap-log.json, capability-registry.json, skill-backlog.json schemas
  • references/proposal-template.md — new skill proposal format
  • references/gap-patterns.md — common gap pattern recognition
  • references/skill-anatomy.md — what makes a good skill

---

Commands Reference

# Gap Management
python scripts/gap_logger.py "description"        # Log a new gap
python scripts/gap_analyzer.py --list             # List all gaps
python scripts/gap_analyzer.py --analyze          # Analyze patterns
python scripts/gap_analyzer.py --report           # Generate priority report

# Skill Proposals & Building
python scripts/skill_proposer.py --gap-id "id"    # Propose from gap
python scripts/skill_proposer.py --interactive    # Interactive proposal builder
python scripts/skill_builder.py --list-proposals  # See pending proposals
python scripts/skill_builder.py --list-gaps       # See open gaps
python scripts/skill_builder.py --proposal FILE   # Build from proposal
python scripts/skill_builder.py --from-gap ID     # Build from gap (fast path)
python scripts/skill_builder.py --name X --purpose Y  # Build directly
python scripts/skill_builder.py --no-sync         # Skip auto-sync

# Registry
python scripts/registry_updater.py --scan         # Scan for new skills
python scripts/registry_updater.py --stats        # Show usage statistics
python scripts/registry_updater.py --unused       # Find unused skills

Related skills

vercel-labsFind SkillsSo their agent can intelligently recommend and install the right modular skills from the open ecosystem when they ask how to do something.3M27.9kopen.feishu.cnLark Skill MakerRapidly create custom skills for Lark (Feishu) that can be invoked by their AI agents and automation workflows.513kanthropicsSkill CreatorGenerate, test, and iterate on new reusable agent skills directly inside their Claude or Cursor workflow.337k166kobraBrainstormingTurn vague product ideas into clear, approved designs and specifications through guided collaborative dialogue before writing any code.307k265kmattpocockWriting Great SkillsCreate high-quality, reusable agent skills that other developers can discover and install from the Skillselion catalog.290k200kagentspace-soFind SkillsInstantly surface the best relevant agent skills, MCP servers, and workflows across multiple registries before starting any new project.226k12
Skill Developmentautomation
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.