hmos-agents-md

Generates and maintains AGENTS.md project convention files for HarmonyOS engineering projects.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/YrracOwl/dsh-hmos-sidebar --skill hmos-agents-md-yrracowl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hmos-agents-md
Source: https://github.com/YrracOwl/dsh-hmos-sidebar/tree/main/packages/dsh-hmos-sidebar/presets/native-harmonyos/skills/hmos-agents-md
Command: npx skills add https://github.com/YrracOwl/dsh-hmos-sidebar --skill hmos-agents-md-yrracowl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? HarmonyOS projects accumulate tribal knowledge—module structure, build commands, signing configs, coding conventions—that AI agents and new team members lack. This Skill keeps a project-root AGENTS.md accurate and automatically injected into every DSH session as persistent context. ## Core Features & Use Cases - Automatic context injection: DSH reads the project-root AGENTS.md at the first pre-step of every session, so the agent always has project conventions without manual reading. - Preview-first generation: The dcli__agents_md tool reads build-profile.json5, app.json5, module.json5, and main_pages.json to generate project overview, modules, SDK versions, and command lists; it previews with apply=false and only writes with apply=true using backup and atomic replacement. - Managed block preservation: Content between DSH-HMOS-MANAGED markers is rebuilt on refresh while custom sections outside the markers (feature lists, acceptance contracts) are preserved. - Use Case: After creating a new HarmonyOS project with dcli__create_project, run the tool to generate an AGENTS.md capturing bundleName, products, page routes, and signing guidance so every future session starts with correct project context. ## Quick Start Generate an AGENTS.md for my HarmonyOS project root using dcli__agents_md in preview mode, then apply it after I confirm the content.

Frequently Asked Questions about hmos-agents-md

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

FAQPage Schema
How do I generate an AGENTS.md for a HarmonyOS project?

Use the dcli__agents_md tool, which reads build-profile.json5, app.json5, module.json5, and main_pages.json to generate project overview, modules, SDK versions, and command lists. It defaults to apply=false preview mode; set apply=true to write with backup and atomic replacement.

How does AGENTS.md get injected into DSH agent sessions?

The dsh-agent-instructions plugin automatically reads the project-root AGENTS.md at the first pre-step of every session and injects it as persistent context. It also reads the user-global ~/.dsh/AGENTS.md and per-directory AGENTS.md or CLAUDE.md files from project root to cwd.

Will refreshing AGENTS.md overwrite my custom sections?

No. Content between the DSH-HMOS-MANAGED START and END markers is rebuilt on refresh, but all content outside the markers is preserved. Place custom sections like feature lists and acceptance contract indexes outside the markers.

What happens if AGENTS.md markers are missing or malformed?

If the old file has no markers, the tool preserves the full original text and appends the managed block at the end. If markers are unpaired, duplicated, or reversed, the tool refuses to write, protecting the existing file.

Should I put signing passwords in AGENTS.md?

No. Never write sensitive information such as passwords or KeyStore passphrases into AGENTS.md. The encrypted storePassword and keyPassword strings in build-profile.json5 should also not be copied into chats, logs, or documents.