story-setup

Deploy OpenCode-based writing infrastructure with non-overwriting file installation.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/LoveIiei/oh-story-opencode --skill story-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-setup
Source: https://github.com/LoveIiei/oh-story-opencode/tree/main/.opencode/skills/story-setup
Command: npx skills add https://github.com/LoveIiei/oh-story-opencode --skill story-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

在开始写作之前,缺少统一的 Agents/Hooks/Rules/指令环境会导致后续拆文、写作、去AI味等流程无法正常运行。该技能通过在用户工作目录中完成基础设施部署,确保整个写作工具链可用且可持续升级。

Core Features & Use Cases

  • 写作环境一键部署(不覆盖):探测现有文件状态后,只部署缺失项(Agent、Hooks、AGENTS.md、规则模板、上下文模板),尽量不打扰用户自定义内容。
  • opencode.json 增量合并(只增不改):将模板中的 instructions/skills/agent/command 按规则追加到用户现有配置中,避免覆盖原配置。
  • 版本与升级模式:读取 .story-deployed 判断是否需要从旧版本升级,并仅部署新增或变更内容,同时输出升级报告。
  • 部署后验证:检查目标文件是否存在且非空,并验证 opencode.json 结构完整性,确保后续技能可直接调用。

Core Features & Use Cases

  • 适用场景
    • 你要开始第一个“网文写作项目”,希望一次性把工具链搭好并可调用子技能。
    • 你已从旧版本迁移到新版,需要升级到新的基础设施并保持原有自定义配置。
    • 你正在已有项目中补齐缺失的 Agents/Hooks/Rules/上下文模板,且希望不覆盖已有内容。

Quick Start

Ask OpenCode to run /story-setup to deploy the required Agents, Hooks, Rules, and project instruction files into your workspace.

Frequently Asked Questions about story-setup

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

FAQPage Schema
How do I set up the OpenCode environment for story writing?

To set up a story writing environment, you can run a deployment process that installs required Agents, Hooks, Rules templates, and project instructions into your workspace. This ensures the entire writing toolchain is available for subsequent tasks.

Will deploying the story writing infrastructure overwrite my existing custom configurations?

Deploying the story writing infrastructure will not overwrite your custom configurations. The process probes existing files and selectively deploys only missing items, while incrementally merging new instructions into your opencode.json without altering original settings.

What is incremental config merge for OpenCode writing projects?

Incremental config merge is a process that appends new instructions, skills, agents, and commands from templates into your existing opencode.json file. It strictly adds configurations without modifying or overwriting your original setup to preserve customizations.

How do I upgrade my OpenCode story writing infrastructure to a new version?

To upgrade your story writing infrastructure, the system reads a deployment marker to detect your current version. It then selectively deploys only newly added or changed files, preserving your customizations, and outputs a detailed upgrade report.

Does the story writing environment deployment work for existing projects?

The story writing environment deployment works for both new and existing projects. For existing projects, it scans the workspace, identifies missing Agents or Rules templates, and fills in the gaps without disturbing your current manuscript or custom files.

What happens after the story writing infrastructure deployment is complete?

After the story writing infrastructure deployment is complete, the system performs a post-deployment integrity validation. It checks that all target files exist and are non-empty, and verifies the opencode.json structure to ensure subsequent writing skills can be called directly.