Kuaifa

{
  "skill_name": "kuaifa",
  "evals": [
    {
      "id": 1,
      "prompt": "我想用 kuaifa 发公众号文章，从来没用过，怎么开始？",
      "expected_output": "Should guide through complete setup: npm install, register at kuaifa.art for API key, set appid/appsecret, set default-author, show template list and recommend setting default-template",
      "files": []
    },
    {
      "id": 2,
      "prompt": "帮我看看有哪些模板可以用，我想换一个好看的模板发布文章",
      "expected_output": "Should run kuaifa template list, explain system templates vs user presets, show how to use --template flag or set default-template",
      "files": []
    },
    {
      "id": 3,
      "prompt": "帮我把 article.md 发到微信草稿箱，封面用 cover.jpg，标题叫 'AI 周报'",
      "expected_output": "Should construct correct publish command: kuaifa publish article.md --title 'AI 周报' --cover cover.jpg --draft",
      "files": []
    },
    {
      "id": 4,
      "prompt": "我有两个公众号，想把同一篇文章分别发到两个号上",
      "expected_output": "Should explain multi-account profiles: profile add, profile use, profile set, or use --account flag to publish to different accounts",
      "files": []
    }
  ]
}

/**
 * Kuaifa Skill for Claude Code
 *
 * Enables Claude to help users publish Markdown articles to WeChat Official Accounts
 * using the kuaifa CLI tool.
 *
 * Official website: https://www.kuaifa.art
 */

export default {
  // Skill metadata
  name: "kuaifa",
  version: "1.2.0",
  description: "Kuaifa (快发) — publish Markdown articles to WeChat Official Accounts via the kuaifa CLI. Use this skill whenever the user wants to publish an article to WeChat, publish image messages, manage kuaifa configuration or templates, or mentions '快发', 'kuaifa', 'publish to WeChat', '发布公众号', '微信发布', '发文章'. Also trigger when the user has a Markdown file and wants to distribute it to WeChat, or asks about WeChat article formatting and themes.",

  // Trigger keywords - when to activate this skill
  triggers: [
    "kuaifa",
    "快发",
    "publish to wechat",
    "wechat official account",
    "微信公众号",
    "发布公众号",
    "微信发布",
    "发文章",
    "wechat article",
    "公众号文章"
  ],

  // Skill configuration
  config: {
    // Path to the main skill prompt
    promptFile: "SKILL.md",

    // Whether this skill has eval tests
    hasEvals: true,

    // Supported languages
    languages: ["zh-CN", "en"],

    // External dependencies
    dependencies: {
      cli: {
        name: "kuaifa",
        packageManager: "npm",
        package: "kuaifa",
        global: true,
        requiredVersion: ">=0.3.0"
      }
    }
  },

  // Utility functions (optional)
  utils: {
    /**
     * Check if kuaifa CLI is installed and get version
     */
    async checkInstallation() {
      try {
        const { execSync } = require('child_process');
        const version = execSync('kuaifa --version', { encoding: 'utf-8' }).trim();
        return { installed: true, version };
      } catch (error) {
        return { installed: false, version: null };
      }
    },

    /**
     * Check if a newer version of kuaifa CLI is available
     */
    async checkForUpdates() {
      try {
        const { execSync } = require('child_process');
        const currentVersion = execSync('kuaifa --version', { encoding: 'utf-8' }).trim();
        const latestVersion = execSync('npm view kuaifa version', { encoding: 'utf-8' }).trim();

        return {
          currentVersion,
          latestVersion,
          updateAvailable: currentVersion !== latestVersion,
          updateCommand: 'npm update -g kuaifa'
        };
      } catch (error) {
        return {
          currentVersion: null,
          latestVersion: null,
          updateAvailable: false,
          error: error.message
        };
      }
    },

    /**
     * Get installation instructions based on system
     */
    getInstallInstructions(platform = process.platform) {
      const instructions = {
        darwin: "npm install -g kuaifa",
        linux: "npm install -g kuaifa",
        win32: "npm install -g kuaifa"
      };
      return instructions[platform] || instructions.darwin;
    },

    /**
     * Get update instructions for kuaifa CLI
     */
    getUpdateInstructions() {
      return {
        cli: "npm update -g kuaifa",
        skill: "cd ~/.claude/skills/kuaifa && git pull origin main"
      };
    },

    /**
     * Common kuaifa commands reference
     */
    commands: {
      publish: "kuaifa publish <file> --title <title> --cover <image>",
      publishNewspic: "kuaifa publish-newspic --title <title> --images <paths...>",
      templateList: "kuaifa template list",
      templatePrompt: "kuaifa template prompt <template-id>",
      configList: "kuaifa config list",
      configSet: "kuaifa config set <key> <value>",
      verifyWechat: "kuaifa config verify-wechat",
      profileList: "kuaifa config profile list",
      profileAdd: "kuaifa config profile add <name>",
      profileUse: "kuaifa config profile use <name>"
    },

    /**
     * Common error messages and solutions
     */
    troubleshooting: {
      "command not found": {
        problem: "kuaifa CLI is not installed",
        solution: "Run: npm install -g kuaifa"
      },
      "未设置 api-key": {
        problem: "API key not configured",
        solution: "Register at https://www.kuaifa.art（或备用 https://api.kuaifa.art）and run: kuaifa config set api-key <key>"
      },
      "缺少封面图": {
        problem: "Missing cover image",
        solution: "Add --cover parameter with local path or URL"
      },
      "缺少文章标题": {
        problem: "Missing article title",
        solution: "Add --title parameter"
      },
      "微信凭证验证失败": {
        problem: "WeChat credentials invalid",
        solution: "Check appid/appsecret on mp.weixin.qq.com"
      },
    }
  },

  // Skill author and maintainer info
  author: {
    name: "shirenchuang",
    url: "https://github.com/shirenchuang/kuaifa"
  },

  // Links
  links: {
    homepage: "https://www.kuaifa.art",
    repository: "https://github.com/shirenchuang/kuaifa",
    issues: "https://github.com/shirenchuang/kuaifa/issues",
    documentation: "https://www.kuaifa.art/docs"
  }
};