Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,18 @@
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "microskill-creator",
"source": {
"source": "local",
"path": "./plugins/microskill-creator"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
}
]
}
19 changes: 17 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"$schema": "https://json.schemastore.org/claude-code-marketplace.json",
"name": "mkdevforge-agents",
"version": "0.3.4",
"version": "0.3.5",
"description": "AI skills and tools from mkdevforge.",
"metadata": {
"version": "0.3.4",
"version": "0.3.5",
"description": "AI skills and tools from mkdevforge."
},
"owner": {
Expand Down Expand Up @@ -41,6 +41,21 @@
"handoff",
"codex"
]
},
{
"name": "microskill-creator",
"description": "Create focused repo-local skills that encode one repeatable behavior.",
"version": "0.1.0",
"author": {
"name": "mkdevforge"
},
"source": "./plugins/microskill-creator",
"category": "development",
"tags": [
"skills",
"repositories",
"monorepos"
]
Comment on lines +45 to +58
}
]
}
21 changes: 21 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ This repository contains AI skills and tools from mkdevforge. Plugins support Co
| --- | --- |
| `ste-writing` | Control documentation, commit messages, and pull-request text with ASD-STE100 rules. |
| `session-handoff` | Continue Claude Code work in Claude or Codex through a Codex-generated checkpoint. |
| `microskill-creator` | Create focused repo-local skills for one repeatable behavior. |

## Install for Codex

Expand All @@ -20,6 +21,16 @@ codex plugin add ste-writing@mkdevforge-agents

Start a new task after installation. Invoke the skill with `$ste-writing`, or ask Codex to rewrite technical prose clearly.

To create a microskill instead, install its plugin and invoke the skill from the target repository:

```powershell
codex plugin add microskill-creator@mkdevforge-agents
```

```text
$create-microskill
```

## Install for Claude Code

Add this repository as a marketplace. Then install the plugin.
Expand All @@ -31,6 +42,16 @@ claude plugin install ste-writing@mkdevforge-agents

Invoke the skill with `/ste-writing:ste-writing`, or ask Claude to rewrite technical prose clearly.

Install and invoke the microskill creator with:

```powershell
claude plugin install microskill-creator@mkdevforge-agents
```

```text
/microskill-creator:create-microskill
```

### Session handoff

The handoff skill requires Node.js 20 or later and an authenticated Codex CLI. Install the marketplace plugin to use its namespaced command.
Expand Down
16 changes: 16 additions & 0 deletions plugins/microskill-creator/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"name": "microskill-creator",
"version": "0.1.0",
"description": "Create focused repo-local skills that encode one repeatable behavior.",
"author": {
"name": "mkdevforge",
"url": "https://github.com/mkdevforge"
},
"homepage": "https://github.com/mkdevforge/agents",
"repository": "https://github.com/mkdevforge/agents",
"keywords": [
"skills",
"repositories",
"monorepos"
]
}
29 changes: 29 additions & 0 deletions plugins/microskill-creator/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
"name": "microskill-creator",
"version": "0.1.0",
"description": "Create focused repo-local skills that encode one repeatable behavior.",
"author": {
"name": "mkdevforge",
"url": "https://github.com/mkdevforge"
},
"homepage": "https://github.com/mkdevforge/agents",
"repository": "https://github.com/mkdevforge/agents",
"keywords": [
"skills",
"repositories",
"monorepos"
],
"skills": "./skills/",
"interface": {
"displayName": "Microskill Creator",
"shortDescription": "Create focused repo-local skills",
"longDescription": "Create or revise a small skill that adds one repeatable behavior to a repository or monorepo project.",
"developerName": "mkdevforge",
"category": "Productivity",
"capabilities": [
"Write"
],
"websiteURL": "https://github.com/mkdevforge/agents",
"defaultPrompt": "Create a microskill for this repository."
}
}
24 changes: 24 additions & 0 deletions plugins/microskill-creator/skills/create-microskill/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
name: create-microskill
description: Use when creating or revising a repo-local skill for one repeatable behavior.
---

# Create a microskill

Find the real repository root and the target project root. Keep them distinct. Read the applicable instructions, existing skills, and relevant code before writing.

Identify the scope first. In a monorepo, find the target project from workspace manifests, build files, and the requested paths. If the behavior is not repo-wide, name the project or stable path in the trigger. Do not silently apply one project's conventions to its siblings.

Reduce the skill to one trigger and one behavior. Narrow it if either needs more than one sentence.

Do not create a microskill when the content belongs in `AGENTS.md`, a script, a test, CI, or documentation. Update an existing skill only when it already owns the same behavior. Different microskills may share a trigger.

Use a short, action-oriented, kebab-case name. Treat the YAML `description` only as the trigger. Start it with `Use when` and do not summarize the body.

Write direct, repo-specific instructions. Add ordering, verification, or stop conditions only when they prevent a real failure. Remove introductions, motivation, generic advice, repeated documentation, and optional improvements.

Keep the body under 25 lines unless correctness requires more. Add supporting files only when instructions alone are insufficient.

Use the repository's existing skill location. If none exists, ask where repo-local skills belong before creating files. Validate the finished skill with the available skill validator.

Remove every sentence that does not change agent behavior.
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
interface:
display_name: "Create Microskill"
short_description: "Create one focused repo-local skill"
default_prompt: "Use $create-microskill to create a focused skill for this repository."