Metal
Skill Verified ActiveExtract the conceptual essence of a repository as skills, agents, and teams — the project's roles, procedures, and coordination patterns expressed as agentskills.io-standard definitions. Reads an arbitrary codebase and produces generalized definitions that capture WHAT the project does and WHO operates it, without replicating HOW it does it. Use when onboarding to a new codebase and wanting to understand its conceptual architecture, when bootstrapping an agentic system from an existing project, when studying a project's organizational DNA for cross-pollination, or when creating a skill/agent/team library inspired by a reference implementation.
To transform implicit project structure and logic into explicit, reusable definitions for agentic systems, onboarding, and knowledge transfer.
Features
- Extracts conceptual essence of repositories
- Produces agentskills.io-standard definitions for skills, agents, and teams
- Identifies roles, procedures, and coordination patterns
- Focuses on project's 'what' and 'who', not 'how'
- Supports various output depths and scope limitations
Use Cases
- Onboarding to new codebases to understand conceptual architecture
- Bootstrapping agentic systems from existing projects
- Studying organizational DNA for cross-pollination
- Creating skill/agent/team libraries inspired by reference implementations
Non-Goals
- Replicating the project's codebase or implementation details
- Generating executable code or detailed step-by-step instructions for specific tasks
- Analyzing code quality or security vulnerabilities (focus is conceptual essence)
Workflow
- Prospect: Survey repository structure, read self-description, identify project boundary.
- Assay: Sample representative files, identify conceptual domains, verbs, roles, and flows, classify as essential/accidental.
- Meditate: Release implementation bias, re-evaluate findings against the Ore Test, abstract to higher levels.
- Smelt: Classify essential concepts into generalized skills, agents, or teams with descriptive names and one-line descriptions.
- Heal: Verify extraction quality, check for over/under-extraction, generalization, and balance.
- Cast: Produce agentskills.io-standard definitions for skills, agents, and teams.
- Temper: Final validation of count, coverage, independence, and pass/fail the Ore Test on all items.
Prerequisites
- Path to the repository or project root directory
- Purpose statement for essence extraction
- Optional: Focus domains
- Optional: Output depth and maximum extractions
Installation
/plugin install agent-almanac@pjt222-agent-almanacQuality Score
VerifiedTrust Signals
Similar Extensions
Lean Ctx
100Context Runtime for AI Agents — 59 MCP tools, 10 read modes, 95+ shell patterns, tree-sitter AST for 18 languages. Compresses LLM context by up to 99%. Use when reading files, running shell commands, searching code, or exploring directories. Auto-installs if not present.
Pathfinder
100Map a codebase into feature-grouped flowcharts, identify duplicated concerns across features, and propose a unified architecture. Use when asked to "find the ideal path," unify duplicated systems, or audit architecture before a refactor. Emits a proposed unified flowchart plus per-system /make-plan prompts.
Codacy Audit
100Codacy Cloud workflow for this repository -- run Codacy's analyzers locally before `git push` (mirrors what Codacy CI runs), and fetch/cluster Codacy issues for any PR via the v3 API. Use when the user mentions Codacy, "codacy analysis", `codacy-analysis-cli`, "codacy issues on PR", "fix codacy CI", "codacy markdownlint findings", or any Codacy gate failing on a netdata-org PR. Ships scripts analyze-local.sh (docker/binary runner for codacy-analysis-cli) and pr-issues.sh (paginated v3 issue fetch + group-by tool/pattern/severity/file). Token-safe -- CODACY_TOKEN never reaches assistant-visible stdout. Read-only by design in the current SOW; write actions (mark FP, mark fixed) are deferred.
Domain Extract
100Extract domain knowledge from existing project sources and generate domain rules. Also handles vault sync and domain listing.
Auto Optimize
100Automate analysis, evaluation, design and optimization of target projects. Integrate VibeGuard as a baseline scan, the remediation process adheres to VibeGuard specifications, and a compliance check is run at the end. Support auto-run-agent autonomous execution.
Understand Domain
100Extract business domain knowledge from a codebase and generate an interactive domain flow graph. Works standalone (lightweight scan) or derives from an existing /understand knowledge graph.