{
  "schema_version": "2026-03-26",
  "generated_at": "2026-01-01T00:00:00+00:00",
  "id": "managing-groups",
  "slug": "managing-groups",
  "display_name": "XMTP groups",
  "description": "Group conversation management for XMTP agents. Use when creating groups, managing members, setting permissions, or sending welcome messages. Triggers on group creation, member management, or permissions.",
  "version": "1.0.0",
  "raw_category": "ai-agents",
  "canonical_category": "ai-agents",
  "taxonomy": {
    "raw_category": "ai-agents",
    "canonical_category": "ai-agents",
    "inferred_category": "ai-agents",
    "category_source": "frontmatter"
  },
  "tags": [],
  "tools": [],
  "complexity": "",
  "risk": "unknown",
  "source": "",
  "author": "xmtp",
  "dates": {
    "added": "",
    "updated": "",
    "file_mtime": "2026-01-01T00:00:00+00:00"
  },
  "paths": {
    "root": "skills/managing-groups",
    "entrypoint": "skills/managing-groups/SKILL.md",
    "metadata": "skills/managing-groups/metadata.json"
  },
  "resources": {
    "sub_resources": [
      "rules"
    ],
    "files": [
      "EXTERNAL_SOURCE.json",
      "ORIGIN.md",
      "SKILL.md",
      "create-group.md",
      "members-add.md",
      "permissions-roles.md",
      "welcome-on-install.md"
    ],
    "files_count": 7,
    "references_count": 0,
    "agents_count": 0,
    "assets_count": 0
  },
  "content": {
    "body_length": 1701,
    "content_length": 2027,
    "body_lines": 70,
    "word_count": 201,
    "has_code_blocks": true,
    "typed_code_blocks_count": 1,
    "has_examples_section": true,
    "example_count": 0,
    "has_workflow_section": true,
    "has_when_to_use_section": false,
    "has_best_practices_section": false,
    "has_troubleshooting_section": false,
    "problem_count": 0,
    "troubleshooting_pairs_count": 0,
    "has_additional_resources_section": false,
    "has_related_skills_section": false,
    "related_skills_count": 0,
    "has_local_support_links": false,
    "local_support_links_count": 0,
    "has_local_script_example": false,
    "local_script_example_count": 0,
    "semantic_signals": {
      "workflow_steps_count": 0,
      "workflow_section_length": 0,
      "when_to_use_section_length": 0,
      "best_practices_items_count": 0,
      "best_practices_section_length": 0,
      "troubleshooting_items_count": 0,
      "troubleshooting_section_length": 0,
      "resources_items_count": 0,
      "resources_section_length": 0,
      "examples_section_length": 385,
      "examples_code_blocks_count": 2,
      "related_skills_section_length": 0,
      "decision_assets_count": 0,
      "table_count": 6,
      "linked_resource_families_count": 0,
      "linked_resource_families": [],
      "support_links_count": 0,
      "support_files_count": 0,
      "references_files_count": 0,
      "scripts_files_count": 0,
      "examples_files_count": 0,
      "agents_files_count": 0,
      "assets_files_count": 0,
      "tools_count": 0,
      "tags_count": 0,
      "body_density": 2.87
    }
  },
  "maturity": {
    "skill_level": 2,
    "skill_level_label": "instructions",
    "has_scripts": false,
    "has_extra_files": true
  },
  "best_practices": {
    "score": 16,
    "tier": "needs-work",
    "signals": {
      "workflow_steps_count": 0,
      "workflow_section_length": 0,
      "when_to_use_section_length": 0,
      "best_practices_items_count": 0,
      "best_practices_section_length": 0,
      "troubleshooting_items_count": 0,
      "troubleshooting_section_length": 0,
      "resources_items_count": 0,
      "resources_section_length": 0,
      "examples_section_length": 385,
      "examples_code_blocks_count": 2,
      "related_skills_section_length": 0,
      "decision_assets_count": 0,
      "table_count": 6,
      "linked_resource_families_count": 0,
      "linked_resource_families": [],
      "support_links_count": 0,
      "support_files_count": 0,
      "references_files_count": 0,
      "scripts_files_count": 0,
      "examples_files_count": 0,
      "agents_files_count": 0,
      "assets_files_count": 0,
      "tools_count": 0,
      "tags_count": 0,
      "body_density": 2.87
    }
  },
  "quality": {
    "score": 38,
    "tier": "starter",
    "breakdown": {
      "body": 10,
      "description": 10,
      "metadata": 3,
      "recency": 7,
      "resources": 5,
      "best_practices": 0,
      "semantic_depth": 1,
      "operational_depth": 2,
      "support_pack": 0
    }
  },
  "security": {
    "score": 90,
    "tier": "review",
    "status": "warn",
    "findings_count": 1,
    "findings": [
      {
        "id": "path-traversal-reference",
        "kind": "suspicious-path",
        "severity": "medium",
        "path": "skills/managing-groups/rules/welcome-on-install.md",
        "message": "Relative parent traversal found in instructions or scripts.",
        "evidence": "See the [creating-inline-actions](../../creating-inline-actions/) skill for implementing `ActionBuilder`.",
        "line": 52
      }
    ],
    "signals": {
      "scanned_files": 7,
      "script_files": 0,
      "binary_like_files": 0
    },
    "scanners": {
      "static": {
        "enabled": true,
        "status": "completed"
      },
      "clamav": {
        "enabled": true,
        "status": "completed",
        "provider": "clamav",
        "detections": [],
        "infected_files": 0
      },
      "virustotal": {
        "enabled": true,
        "status": "completed",
        "provider": "virustotal",
        "lookups": 0,
        "positives": 0,
        "results": [],
        "details": "Hash lookups only. Unknown files are not uploaded during validation."
      }
    }
  },
  "validation": {
    "errors": [],
    "warnings": [
      "tags are empty",
      "tools are empty",
      "security medium: Relative parent traversal found in instructions or scripts. [skills/managing-groups/rules/welcome-on-install.md]"
    ],
    "status": "warn"
  }
}