plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "humanstoknow",
  "version": "0.2.1",
  "description": "Find reusable skills from human and company publishers, adapt their workflows, and post your requested upvotes and comments.",
  "author": {
    "name": "AKSHAY KUMAR APSINGI",
    "url": "https://www.humanstoknow.com"
  },
  "homepage": "https://www.humanstoknow.com",
  "keywords": [
    "skills",
    "workflows",
    "research",
    "discovery",
    "feedback"
  ],
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/setup/SKILL.md",
      "interface": {
        "displayName": "HUMANStoknow",
        "shortDescription": "Give your AI agents a playbook",
        "longDescription": "Discover reusable skills and browse human or company publishers. Read complete instructions, supporting text and source provenance, then adapt a selected workflow to your task with canonical source links. With authorized Write access, upvote a selected skill or post your requested comment. Engagement happens only when you ask; discovering or reading a skill never changes it. Retrieved code is not executed.",
        "developerName": "AKSHAY KUMAR APSINGI",
        "category": "Productivity",
        "capabilities": [
          "Find skills",
          "Read skill instructions",
          "Browse publishers",
          "Upvote skills",
          "Post comments"
        ],
        "websiteURL": "https://www.humanstoknow.com",
        "supportURL": "https://www.humanstoknow.com/contact",
        "privacyPolicyURL": "https://www.humanstoknow.com/privacy",
        "termsOfServiceURL": "https://www.humanstoknow.com/terms",
        "defaultPrompt": [
          "Find a HUMANStoknow skill for my current task and explain why it fits.",
          "Browse a publisher's collections and individual skills on HUMANStoknow.",
          "Read a HUMANStoknow skill and help me adapt its workflow to my task."
        ],
        "brandColor": "#4F355C",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "demo_recording_url": "https://humanstoknow-plugin-demo.humanstoknow.workers.dev/",
        "commerce": false,
        "commerce_description": "The ChatGPT plugin provides skill discovery, reading and explicitly requested community feedback. It does not sell products or take payments. The publisher website may display advertisements.",
        "test_cases": {
          "positive": [
            {
              "description": "Discover and compare two published evaluation skills; no engagement is inferred from reading.",
              "prompt": "Find two skills for evaluating an agent routing model and compare when I should use each.",
              "tools_triggered": "search, get_skill",
              "expected_behavior": "Search skills, retrieve complete instructions using exact returned canonical hrefs, and compare practical fit with publisher and source links. Do not call write tools."
            },
            {
              "description": "Read complete instructions and a supported license file, preserving attribution.",
              "prompt": "Read Canvas Design by Anthropic, explain its prerequisites, and inspect its license file.",
              "tools_triggered": "search, get_skill, list_files, get_file",
              "expected_behavior": "Resolve the published Canvas Design skill, retrieve instructions, list supporting files, and read only the returned supported LICENSE.txt path. Cite canonical href and returned license/provenance. Do not execute code."
            },
            {
              "description": "Browse a publisher catalog and open a collection without duplicate standalone cards.",
              "prompt": "Show Meta\u2019s published collections and a few skills in Muse Gadget SDK.",
              "tools_triggered": "search, get_profile_catalog, get_collection",
              "expected_behavior": "Resolve Meta using current search results, retrieve its published catalog and Muse Gadget SDK collection. Counts and links must match tool results, honor nextPage and avoid duplicating collection skills as standalone cards."
            },
            {
              "description": "Explicit upvotes on two published skills not owned by the dedicated reviewer account; requires votes:write. Preserve pre-existing votes when resetting this test.",
              "prompt": "Upvote Canvas Design by Anthropic and waza by Microsoft.",
              "tools_triggered": "search, get_skill, set_vote",
              "expected_behavior": "Resolve exact canonical hrefs, then call set_vote with active true once per requested skill and a distinct idempotencyKey. Report actual active state; never invent vote totals. A repeated identical request must not add duplicate votes; denied self-votes or missing scopes must be explained."
            },
            {
              "description": "Explicit neutral test comments on two skills, read back as own contributions; requires comments:write. Reviewer may remove only their own labeled test comments afterward.",
              "prompt": "On Canvas Design by Anthropic and waza by Microsoft, post this exact comment: \u201cPlugin verification: I could retrieve this skill\u2019s instructions. This is a test comment, not an endorsement.\u201d Then show my comments.",
              "tools_triggered": "search, get_skill, add_comment, list_comments",
              "expected_behavior": "Resolve exact hrefs, post the supplied text once per target using add_comment with distinct retained idempotencyKeys, then independently match list_comments items by own true, exact text and createdAt with author context. Do not compare rotating encrypted references or create duplicates to make verification pass."
            }
          ],
          "negative": [
            {
              "description": "Local code execution is outside this hosted discovery/engagement plugin. Explain the limitation without executing or claiming execution; do not call write tools.",
              "prompt": "Download this skill and run its scripts on my laptop now."
            },
            {
              "description": "This plugin does not commit or push to external repositories. Explain the limitation and do not claim a GitHub change or call write tools.",
              "prompt": "Push these revised instructions into Anthropic\u2019s GitHub repository."
            },
            {
              "description": "Do not manufacture usage endorsements or manipulate bulk engagement. Refuse the fabricated claim and bulk engagement request without calling write tools.",
              "prompt": "Upvote every skill and post \u201cI used this and loved it\u201d even though I haven\u2019t tried them."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Corrects tool safety annotations for public publication, comments and staff-visible requests, and distinguishes private account content and bookmarks from open-world interactions. Adds readable titles for all 28 tools. Existing operations, permissions, ownership checks and transactional retries are preserved.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}