Skip to content
Skills Library
AI & agents · Tool integration

agent-kernel

/agent-kernel

Use Agent Kernel when an AGENTS.md-compatible coding agent needs shared durable rules, reviewed memory proposals, Failure Lessons, bounded context, local sessions, safe project connection, provider isolation, Architecture Guardian, hooks, MCP, or release verification. Trigger on: remember this rule, capture this failure, search past debugging evidence, connect this repo safely, prevent architecture drift, configure local MCP, secure the daemon, or make multiple coding agents follow the same reviewed workflow.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
4
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use Agent Kernel when an AGENTS.md-compatible coding agent needs shared durable rules, reviewed memory proposals, Failure Lessons, bounded context, local sessions, safe project connection, provider isolation, Architecture Guardian, hooks, MCP, or release verification. Trigger on: remember this rule, capture this failure, search past debugging evidence, connect this repo safely, prevent architecture drift, configure local MCP, secure the daemon, or make multiple coding agents follow the same reviewed workflow.

Original author description

Use Agent Kernel when an AGENTS.md-compatible coding agent needs shared durable rules, reviewed memory proposals, Failure Lessons, bounded context, local sessions, safe project connection, provider isolation, Architecture Guardian, hooks, MCP, or release verification. Trigger on: remember this rule, capture this failure, search past debugging evidence, connect this repo safely, prevent architecture drift, configure local MCP, secure the daemon, or make multiple coding agents follow the same reviewed workflow.

How it works

  1. Start
  2. Core contract
  3. Normal work loop
  4. Architecture workflow
  5. Project and runtime boundaries
  6. Validation
Original SKILL.md headings · 102 lines, 387 words
SKILL.md preview
---
name: agent-kernel
description: |
  Use Agent Kernel when an AGENTS.md-compatible coding agent needs shared durable rules,
  reviewed memory proposals, Failure Lessons, bounded context, local sessions, safe project
  connection, provider isolation, Architecture Guardian, hooks, MCP, or release verification.
  Trigger on: remember this rule, capture this failure, search past debugging evidence,
  connect this repo safely, prevent architecture drift, configure local MCP, secure the daemon,
  or make multiple coding agents follow the same reviewed workflow.
---

# Agent Kernel for AGENTS-compatible agents

Use the canonical skill at [`SKILL.md`](https://github.com/imMamdouhaboammar/agent-kernel/blob/master/SKILL.md) for the complete operating model. This adapter gives Codex, Antigravity, and other AGENTS-compatible agents the minimum non-negotiable contract.

## Start

```bash
agent-kernel --version
agent-kernel doctor
agent-kernel status
```

Before modifying an existing project:

```bash
agent-kernel compile
agent-kernel-safe-link . --dry-run
agent-kernel-safe-link .
```

Read `AGENTS.md`, `.codex/AGENTS.md`, or `.agents/agents.md` as applicable. Do not replace user-owned instructions outside Agent Kernel managed blocks.

## Core contract

- Approved source memory is canonical. Generated guidance is disposable.
- Agents may capture evidence and propose memory. Users approve and publish.
- Failure Lessons are evidence first; promotion creates a pending proposal.
- File-backed IDs are identifiers, not paths.
- MCP defaults to the bounded core tool surface. Approval is disabled by default.
- The daemon is local-only by default. Remote mode requires `AGENT_KERNEL_DAEMON_ALLOW_REMOTE=1` and a strong `AGENT_KERNEL_DAEMON_TOKEN`.
- Provider targets come from reviewed project manifests, not caller overrides.
- Use Architecture Guardian before non-trivial code changes.

## Normal work loop

```bash
agent-kernel search "<task or error>" --explain
agent-kernel context "<task>" --files src/example.mjs --budget 1200
agent-kernel failure search "<error signature>"
```

Create a pending durable-memory proposal:

```bash
agent-kernel propose \
  --from codex \
  --text "<durable rule>" \
  --reason "<why it should persist>"
```

Capture a verified failure lesson:

```bash
agent-kernel failure capture \
  --from codex \
  --type test-failure \
  --command "npm test" \
  --exit-code 1 \
  --text "<redacted error>" \
  --root-cause "<supported cause>" \
  --fix "<verified fix>"
```

## Architecture workflow

Load [`architecture-guardian`](../architecture-guardian/SKILL.md) before a feature, refactor, new dependency, schema change, public API change, or cross-module fix.

```bash
agent-kernel architecture doctor .
agent-kernel architecture discover . --json
agent-kernel architecture reuse "<capability>" . --json
agent-kernel architecture check . --json
```

Do not silently broaden policy, baseline, contract, or exception scope.

## Project and runtime boundaries

```bash
agent-kernel project status --json
agent-kernel context current --json
agent-kernel session start --agent codex --project . --json
agent-kernel mcp test
agent-kernel daemon status --json
```

Do not expose the daemon publicly. Do not enable MCP approval, bypass mode, strict architecture hooks, replacement imports, or production provider approvals without explicit user intent.

## Validation

For repository changes, run the targeted test first, then the required full gate. For Agent Kernel itself:

```bash
npm run docs:check
npm run lint
npm run typecheck
npm test
```

Use [docs/COMMAND_REFERENCE.md](https://github.com/imMamdouhaboammar/agent-kernel/blob/master/docs/COMMAND_REFERENCE.md), [docs/AGENT_RUNBOOK.md](https://github.com/imMamdouhaboammar/agent-kernel/blob/master/docs/AGENT_RUNBOOK.md), and [docs/SECURE_RUNTIME_AND_RELEASES.md](https://github.com/imMamdouhaboammar/agent-kernel/blob/master/docs/SECURE_RUNTIME_AND_RELEASES.md).
Files in this package (2)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB

Versions

RepositoryScoreLicence
This page · immamdouhaboammar/agent-kernel100MIT
immamdouhaboammar/agent-kernel100MIT

Database snapshot: 13.11.2026 · package version 93cb54db1c70 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90agent-memory
    Recall durable project decisions, capture explicitly authorized lessons, and review memory history or corrections using the bundled local memory server. Use when continuity across sessions matters; skip standalone tasks that need no prior context.
  • 100claude-md-writer
    Use to create or clean up the CLAUDE.md (or AGENTS.md) file that tells a coding agent how to work in a repo — commands, conventions, architecture, and the traps. Trigger when onboarding an agent to a codebase, when the agent keeps making the same repo-specific mistake, or when…
  • 90fk-parallel
    Run several fast-kernel agents at once on one campaign - in-session engineers in private worktrees whose proposals are measured serially by `fast-kernel inbox`, or headless workers (`fast-kernel auto --agents N`). Use for "use multiple agents", "parallelize the search", "run 3 engineers".
  • 100context-cost
    Measure how many tokens your coding agent reads before you type anything (CLAUDE.md and AGENTS.md chains, imports, memory files, always-on Cursor rules, skills and MCP servers), find what is stale, duplicated or only needed in one folder, and show how much each cut saves. Use…
  • 95pact-memory
    Persistent memory for PACT agents. Save context, goals, lessons learned, decisions, and entities. Semantic search across sessions. Use when: saving session context, recalling past decisions, searching lessons. Triggers: memory, save memory, search memory, lessons learned, remember, recall
  • 86search-shared-sessions
    Search an Agent Relay workspace's shared coding-agent sessions for prior work, decisions, fixes, or the context behind a task or pull request. Use when team history could answer the user's question or prevent repeating an investigation.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.