new-surface

Automates creation of command, agent, or skill surfaces in MindrianOS.

2|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/jsagir/mindrian-os-plugin --skill new-surface
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-surface
Source: https://github.com/jsagir/mindrian-os-plugin/tree/main/skills/new-surface
Command: npx skills add https://github.com/jsagir/mindrian-os-plugin --skill new-surface

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps streamline the process of creating new command, agent, or skill surfaces within the MindrianOS framework by automatically generating the necessary connector wiring and updating the registry and manifest.

Core Features & Use Cases

  • Automatic Surface Creation: Generates the .md file with the correct 11-key connector frontmatter for a new surface.
  • Registry and Manifest Update: Regenerates the connector-registry and harness-manifest to include the new surface.
  • Use Case: When adding a new command, agent, or skill to the harness, this Skill simplifies the process by automating the creation of the surface file and updating the necessary components.

Quick Start

To create a new surface, use the command: /mos:new-surface --spec /path/to/surface-spec.json

Frequently Asked Questions about new-surface

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new command or agent surface in the MindrianOS framework?

To create a new surface in MindrianOS, use the `/mos:new-surface` command with a JSON spec file. The Skill automatically generates the surface file with the correct 11-key connector frontmatter and updates the necessary system files.

What is the 11-key connector system required for surface creation?

The 11-key connector system is the frontmatter standard used by the MindrianOS framework to wire new commands, agents, or skills. Understanding this connector structure is a prerequisite for properly adding new components to the harness.

How do I update the connector-registry and harness-manifest after adding a new skill?

Updating the connector-registry and harness-manifest happens automatically when you use the surface creation Skill. It regenerates both files to include your new component, eliminating the need for manual registry updates.

Can I use this surface creation tool without prior knowledge of the MindrianOS connector system?

No, this Skill is designed for users who already have knowledge of the framework's 11-key connector system. While it automates file generation and registry updates, you need to understand the connector wiring to define your surface spec correctly.

What is the best way to automate framework development for new MindrianOS components?

Automating framework development is best handled by generating the necessary connector wiring through a surface spec JSON file. This approach automatically creates the required `.md` file and synchronizes the harness-manifest.

Why does my new command surface not appear in the harness-manifest after manual creation?

Manual creation bypasses the automated registry and manifest updates required by the MindrianOS framework. Using the surface creation Skill ensures the connector-registry and harness-manifest are properly regenerated to include the new surface.