@vantagesec/socc 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (127) hide show
  1. package/README.md +8 -8
  2. package/dist/cli.mjs +10734 -10807
  3. package/package.json +7 -8
  4. package/scripts/bootstrap-socc-soul.mjs +23 -1
  5. package/socc-canonical/.agents/generated/socc-agent-manifest.json +0 -231
  6. package/socc-canonical/.agents/generated/socc-agent.md +0 -256
  7. package/socc-canonical/.agents/rules/AGENT.md +0 -109
  8. package/socc-canonical/.agents/rules/AQL_REFERENCE.md +0 -40
  9. package/socc-canonical/.agents/rules/MEMORY.md +0 -19
  10. package/socc-canonical/.agents/rules/TOOLS.md +0 -48
  11. package/socc-canonical/.agents/soc-copilot/AGENTS.md +0 -28
  12. package/socc-canonical/.agents/soc-copilot/MEMORY.md +0 -20
  13. package/socc-canonical/.agents/soc-copilot/SKILL.md +0 -51
  14. package/socc-canonical/.agents/soc-copilot/SOUL.md +0 -31
  15. package/socc-canonical/.agents/soc-copilot/TOOLS.md +0 -33
  16. package/socc-canonical/.agents/soc-copilot/USER.md +0 -31
  17. package/socc-canonical/.agents/soc-copilot/identity.md +0 -7
  18. package/socc-canonical/.agents/soc-copilot/references/evidence-rules.md +0 -30
  19. package/socc-canonical/.agents/soc-copilot/references/intelligence-source-registry.md +0 -32
  20. package/socc-canonical/.agents/soc-copilot/references/ioc-extraction.md +0 -25
  21. package/socc-canonical/.agents/soc-copilot/references/knowledge-ingestion-policy.md +0 -34
  22. package/socc-canonical/.agents/soc-copilot/references/mitre-guidance.md +0 -21
  23. package/socc-canonical/.agents/soc-copilot/references/output-contract.md +0 -31
  24. package/socc-canonical/.agents/soc-copilot/references/security-json-patterns.md +0 -129
  25. package/socc-canonical/.agents/soc-copilot/references/telemetry-investigation-patterns.md +0 -39
  26. package/socc-canonical/.agents/soc-copilot/schemas/analysis_response.json +0 -119
  27. package/socc-canonical/.agents/soc-copilot/skills/code-review-excellence/SKILL.md +0 -538
  28. package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/QUICK_REFERENCE.md +0 -263
  29. package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/README.md +0 -243
  30. package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/SKILL.md +0 -1707
  31. package/socc-canonical/.agents/soc-copilot/skills/cybersecurity-analyst/tests/quiz.md +0 -472
  32. package/socc-canonical/.agents/soc-copilot/skills/data-visualization/SKILL.md +0 -304
  33. package/socc-canonical/.agents/soc-copilot/skills/deep-research/SKILL.md +0 -192
  34. package/socc-canonical/.agents/soc-copilot/skills/excel-analysis/SKILL.md +0 -247
  35. package/socc-canonical/.agents/soc-copilot/skills/find-skills/SKILL.md +0 -133
  36. package/socc-canonical/.agents/soc-copilot/skills/humanizer/README.md +0 -120
  37. package/socc-canonical/.agents/soc-copilot/skills/humanizer/SKILL.md +0 -439
  38. package/socc-canonical/.agents/soc-copilot/skills/malware-behavior/SKILL.md +0 -54
  39. package/socc-canonical/.agents/soc-copilot/skills/mitre/SKILL.md +0 -200
  40. package/socc-canonical/.agents/soc-copilot/skills/observability-logs-search/SKILL.md +0 -237
  41. package/socc-canonical/.agents/soc-copilot/skills/observability-logs-search/references/log-search-reference.md +0 -76
  42. package/socc-canonical/.agents/soc-copilot/skills/payload-triage/SKILL.md +0 -53
  43. package/socc-canonical/.agents/soc-copilot/skills/phishing-analysis/SKILL.md +0 -51
  44. package/socc-canonical/.agents/soc-copilot/skills/prd/SKILL.md +0 -143
  45. package/socc-canonical/.agents/soc-copilot/skills/remembering-conversations/MCP-TOOLS.md +0 -137
  46. package/socc-canonical/.agents/soc-copilot/skills/remembering-conversations/SKILL.md +0 -65
  47. package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/README.md +0 -118
  48. package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/SKILL.md +0 -93
  49. package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/references/advanced.md +0 -122
  50. package/socc-canonical/.agents/soc-copilot/skills/sequential-thinking/references/examples.md +0 -274
  51. package/socc-canonical/.agents/soc-copilot/skills/soc-generalist/SKILL.md +0 -53
  52. package/socc-canonical/.agents/soc-copilot/skills/suspicious-url/SKILL.md +0 -51
  53. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/CREATION-LOG.md +0 -119
  54. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/SKILL.md +0 -296
  55. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/condition-based-waiting-example.ts +0 -158
  56. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/condition-based-waiting.md +0 -115
  57. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/defense-in-depth.md +0 -122
  58. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/find-polluter.sh +0 -63
  59. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/root-cause-tracing.md +0 -169
  60. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-academic.md +0 -14
  61. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-pressure-1.md +0 -58
  62. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-pressure-2.md +0 -68
  63. package/socc-canonical/.agents/soc-copilot/skills/systematic-debugging/test-pressure-3.md +0 -69
  64. package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/SKILL.md +0 -284
  65. package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/chinese-traditional.md +0 -535
  66. package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/english.md +0 -372
  67. package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/japanese.md +0 -515
  68. package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/tools-resources.md +0 -527
  69. package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/translation-challenges.md +0 -603
  70. package/socc-canonical/.agents/soc-copilot/skills/web-search/SKILL.md +0 -322
  71. package/socc-canonical/.agents/soc-copilot/skills.md +0 -21
  72. package/socc-canonical/.agents/workflows/SOP.md +0 -137
  73. package/socc-canonical/README.md +0 -10
  74. /package/{.claude → .socc}/agents/socc.md +0 -0
  75. /package/{.claude → .socc}/references/evidence-rules.md +0 -0
  76. /package/{.claude → .socc}/references/intelligence-source-registry.md +0 -0
  77. /package/{.claude → .socc}/references/ioc-extraction.md +0 -0
  78. /package/{.claude → .socc}/references/knowledge-ingestion-policy.md +0 -0
  79. /package/{.claude → .socc}/references/mitre-guidance.md +0 -0
  80. /package/{.claude → .socc}/references/output-contract.md +0 -0
  81. /package/{.claude → .socc}/references/security-json-patterns.md +0 -0
  82. /package/{.claude → .socc}/references/telemetry-investigation-patterns.md +0 -0
  83. /package/{.claude → .socc}/rules/socc-business-rules.md +0 -0
  84. /package/{.claude → .socc}/skills/code-review-excellence/SKILL.md +0 -0
  85. /package/{.claude → .socc}/skills/cybersecurity-analyst/QUICK_REFERENCE.md +0 -0
  86. /package/{.claude → .socc}/skills/cybersecurity-analyst/README.md +0 -0
  87. /package/{.claude → .socc}/skills/cybersecurity-analyst/SKILL.md +0 -0
  88. /package/{.claude → .socc}/skills/cybersecurity-analyst/tests/quiz.md +0 -0
  89. /package/{.claude → .socc}/skills/data-visualization/SKILL.md +0 -0
  90. /package/{.claude → .socc}/skills/deep-research/SKILL.md +0 -0
  91. /package/{.claude → .socc}/skills/excel-analysis/SKILL.md +0 -0
  92. /package/{.claude → .socc}/skills/find-skills/SKILL.md +0 -0
  93. /package/{.claude → .socc}/skills/humanizer/README.md +0 -0
  94. /package/{.claude → .socc}/skills/humanizer/SKILL.md +0 -0
  95. /package/{.claude → .socc}/skills/malware-behavior/SKILL.md +0 -0
  96. /package/{.claude → .socc}/skills/mitre/SKILL.md +0 -0
  97. /package/{.claude → .socc}/skills/observability-logs-search/SKILL.md +0 -0
  98. /package/{.claude → .socc}/skills/observability-logs-search/references/log-search-reference.md +0 -0
  99. /package/{.claude → .socc}/skills/payload-triage/SKILL.md +0 -0
  100. /package/{.claude → .socc}/skills/phishing-analysis/SKILL.md +0 -0
  101. /package/{.claude → .socc}/skills/prd/SKILL.md +0 -0
  102. /package/{.claude → .socc}/skills/remembering-conversations/MCP-TOOLS.md +0 -0
  103. /package/{.claude → .socc}/skills/remembering-conversations/SKILL.md +0 -0
  104. /package/{.claude → .socc}/skills/sequential-thinking/README.md +0 -0
  105. /package/{.claude → .socc}/skills/sequential-thinking/SKILL.md +0 -0
  106. /package/{.claude → .socc}/skills/sequential-thinking/references/advanced.md +0 -0
  107. /package/{.claude → .socc}/skills/sequential-thinking/references/examples.md +0 -0
  108. /package/{.claude → .socc}/skills/soc-generalist/SKILL.md +0 -0
  109. /package/{.claude → .socc}/skills/suspicious-url/SKILL.md +0 -0
  110. /package/{.claude → .socc}/skills/systematic-debugging/CREATION-LOG.md +0 -0
  111. /package/{.claude → .socc}/skills/systematic-debugging/SKILL.md +0 -0
  112. /package/{.claude → .socc}/skills/systematic-debugging/condition-based-waiting-example.ts +0 -0
  113. /package/{.claude → .socc}/skills/systematic-debugging/condition-based-waiting.md +0 -0
  114. /package/{.claude → .socc}/skills/systematic-debugging/defense-in-depth.md +0 -0
  115. /package/{.claude → .socc}/skills/systematic-debugging/find-polluter.sh +0 -0
  116. /package/{.claude → .socc}/skills/systematic-debugging/root-cause-tracing.md +0 -0
  117. /package/{.claude → .socc}/skills/systematic-debugging/test-academic.md +0 -0
  118. /package/{.claude → .socc}/skills/systematic-debugging/test-pressure-1.md +0 -0
  119. /package/{.claude → .socc}/skills/systematic-debugging/test-pressure-2.md +0 -0
  120. /package/{.claude → .socc}/skills/systematic-debugging/test-pressure-3.md +0 -0
  121. /package/{.claude → .socc}/skills/translation-expertise/SKILL.md +0 -0
  122. /package/{.claude → .socc}/skills/translation-expertise/chinese-traditional.md +0 -0
  123. /package/{.claude → .socc}/skills/translation-expertise/english.md +0 -0
  124. /package/{.claude → .socc}/skills/translation-expertise/japanese.md +0 -0
  125. /package/{.claude → .socc}/skills/translation-expertise/tools-resources.md +0 -0
  126. /package/{.claude → .socc}/skills/translation-expertise/translation-challenges.md +0 -0
  127. /package/{.claude → .socc}/skills/web-search/SKILL.md +0 -0
@@ -1,247 +0,0 @@
1
- ---
2
- name: Excel Analysis
3
- description: Analyze Excel spreadsheets, create pivot tables, generate charts, and perform data analysis. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
4
- ---
5
-
6
- # Excel Analysis
7
-
8
- ## Quick start
9
-
10
- Read Excel files with pandas:
11
-
12
- ```python
13
- import pandas as pd
14
-
15
- # Read Excel file
16
- df = pd.read_excel("data.xlsx", sheet_name="Sheet1")
17
-
18
- # Display first few rows
19
- print(df.head())
20
-
21
- # Basic statistics
22
- print(df.describe())
23
- ```
24
-
25
- ## Reading multiple sheets
26
-
27
- Process all sheets in a workbook:
28
-
29
- ```python
30
- import pandas as pd
31
-
32
- # Read all sheets
33
- excel_file = pd.ExcelFile("workbook.xlsx")
34
-
35
- for sheet_name in excel_file.sheet_names:
36
- df = pd.read_excel(excel_file, sheet_name=sheet_name)
37
- print(f"\n{sheet_name}:")
38
- print(df.head())
39
- ```
40
-
41
- ## Data analysis
42
-
43
- Perform common analysis tasks:
44
-
45
- ```python
46
- import pandas as pd
47
-
48
- df = pd.read_excel("sales.xlsx")
49
-
50
- # Group by and aggregate
51
- sales_by_region = df.groupby("region")["sales"].sum()
52
- print(sales_by_region)
53
-
54
- # Filter data
55
- high_sales = df[df["sales"] > 10000]
56
-
57
- # Calculate metrics
58
- df["profit_margin"] = (df["revenue"] - df["cost"]) / df["revenue"]
59
-
60
- # Sort by column
61
- df_sorted = df.sort_values("sales", ascending=False)
62
- ```
63
-
64
- ## Creating Excel files
65
-
66
- Write data to Excel with formatting:
67
-
68
- ```python
69
- import pandas as pd
70
-
71
- df = pd.DataFrame({
72
- "Product": ["A", "B", "C"],
73
- "Sales": [100, 200, 150],
74
- "Profit": [20, 40, 30]
75
- })
76
-
77
- # Write to Excel
78
- writer = pd.ExcelWriter("output.xlsx", engine="openpyxl")
79
- df.to_excel(writer, sheet_name="Sales", index=False)
80
-
81
- # Get worksheet for formatting
82
- worksheet = writer.sheets["Sales"]
83
-
84
- # Auto-adjust column widths
85
- for column in worksheet.columns:
86
- max_length = 0
87
- column_letter = column[0].column_letter
88
- for cell in column:
89
- if len(str(cell.value)) > max_length:
90
- max_length = len(str(cell.value))
91
- worksheet.column_dimensions[column_letter].width = max_length + 2
92
-
93
- writer.close()
94
- ```
95
-
96
- ## Pivot tables
97
-
98
- Create pivot tables programmatically:
99
-
100
- ```python
101
- import pandas as pd
102
-
103
- df = pd.read_excel("sales_data.xlsx")
104
-
105
- # Create pivot table
106
- pivot = pd.pivot_table(
107
- df,
108
- values="sales",
109
- index="region",
110
- columns="product",
111
- aggfunc="sum",
112
- fill_value=0
113
- )
114
-
115
- print(pivot)
116
-
117
- # Save pivot table
118
- pivot.to_excel("pivot_report.xlsx")
119
- ```
120
-
121
- ## Charts and visualization
122
-
123
- Generate charts from Excel data:
124
-
125
- ```python
126
- import pandas as pd
127
- import matplotlib.pyplot as plt
128
-
129
- df = pd.read_excel("data.xlsx")
130
-
131
- # Create bar chart
132
- df.plot(x="category", y="value", kind="bar")
133
- plt.title("Sales by Category")
134
- plt.xlabel("Category")
135
- plt.ylabel("Sales")
136
- plt.tight_layout()
137
- plt.savefig("chart.png")
138
-
139
- # Create pie chart
140
- df.set_index("category")["value"].plot(kind="pie", autopct="%1.1f%%")
141
- plt.title("Market Share")
142
- plt.ylabel("")
143
- plt.savefig("pie_chart.png")
144
- ```
145
-
146
- ## Data cleaning
147
-
148
- Clean and prepare Excel data:
149
-
150
- ```python
151
- import pandas as pd
152
-
153
- df = pd.read_excel("messy_data.xlsx")
154
-
155
- # Remove duplicates
156
- df = df.drop_duplicates()
157
-
158
- # Handle missing values
159
- df = df.fillna(0) # or df.dropna()
160
-
161
- # Remove whitespace
162
- df["name"] = df["name"].str.strip()
163
-
164
- # Convert data types
165
- df["date"] = pd.to_datetime(df["date"])
166
- df["amount"] = pd.to_numeric(df["amount"], errors="coerce")
167
-
168
- # Save cleaned data
169
- df.to_excel("cleaned_data.xlsx", index=False)
170
- ```
171
-
172
- ## Merging and joining
173
-
174
- Combine multiple Excel files:
175
-
176
- ```python
177
- import pandas as pd
178
-
179
- # Read multiple files
180
- df1 = pd.read_excel("sales_q1.xlsx")
181
- df2 = pd.read_excel("sales_q2.xlsx")
182
-
183
- # Concatenate vertically
184
- combined = pd.concat([df1, df2], ignore_index=True)
185
-
186
- # Merge on common column
187
- customers = pd.read_excel("customers.xlsx")
188
- sales = pd.read_excel("sales.xlsx")
189
-
190
- merged = pd.merge(sales, customers, on="customer_id", how="left")
191
-
192
- merged.to_excel("merged_data.xlsx", index=False)
193
- ```
194
-
195
- ## Advanced formatting
196
-
197
- Apply conditional formatting and styles:
198
-
199
- ```python
200
- import pandas as pd
201
- from openpyxl import load_workbook
202
- from openpyxl.styles import PatternFill, Font
203
-
204
- # Create Excel file
205
- df = pd.DataFrame({
206
- "Product": ["A", "B", "C"],
207
- "Sales": [100, 200, 150]
208
- })
209
-
210
- df.to_excel("formatted.xlsx", index=False)
211
-
212
- # Load workbook for formatting
213
- wb = load_workbook("formatted.xlsx")
214
- ws = wb.active
215
-
216
- # Apply conditional formatting
217
- red_fill = PatternFill(start_color="FF0000", end_color="FF0000", fill_type="solid")
218
- green_fill = PatternFill(start_color="00FF00", end_color="00FF00", fill_type="solid")
219
-
220
- for row in range(2, len(df) + 2):
221
- cell = ws[f"B{row}"]
222
- if cell.value < 150:
223
- cell.fill = red_fill
224
- else:
225
- cell.fill = green_fill
226
-
227
- # Bold headers
228
- for cell in ws[1]:
229
- cell.font = Font(bold=True)
230
-
231
- wb.save("formatted.xlsx")
232
- ```
233
-
234
- ## Performance tips
235
-
236
- - Use `read_excel` with `usecols` to read specific columns only
237
- - Use `chunksize` for very large files
238
- - Consider using `engine='openpyxl'` or `engine='xlrd'` based on file type
239
- - Use `dtype` parameter to specify column types for faster reading
240
-
241
- ## Available packages
242
-
243
- - **pandas** - Data analysis and manipulation (primary)
244
- - **openpyxl** - Excel file creation and formatting
245
- - **xlrd** - Reading older .xls files
246
- - **xlsxwriter** - Advanced Excel writing capabilities
247
- - **matplotlib** - Chart generation
@@ -1,133 +0,0 @@
1
- ---
2
- name: find-skills
3
- description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
4
- ---
5
-
6
- # Find Skills
7
-
8
- This skill helps you discover and install skills from the open agent skills ecosystem.
9
-
10
- ## When to Use This Skill
11
-
12
- Use this skill when the user:
13
-
14
- - Asks "how do I do X" where X might be a common task with an existing skill
15
- - Says "find a skill for X" or "is there a skill for X"
16
- - Asks "can you do X" where X is a specialized capability
17
- - Expresses interest in extending agent capabilities
18
- - Wants to search for tools, templates, or workflows
19
- - Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
20
-
21
- ## What is the Skills CLI?
22
-
23
- The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
24
-
25
- **Key commands:**
26
-
27
- - `npx skills find [query]` - Search for skills interactively or by keyword
28
- - `npx skills add <package>` - Install a skill from GitHub or other sources
29
- - `npx skills check` - Check for skill updates
30
- - `npx skills update` - Update all installed skills
31
-
32
- **Browse skills at:** https://skills.sh/
33
-
34
- ## How to Help Users Find Skills
35
-
36
- ### Step 1: Understand What They Need
37
-
38
- When a user asks for help with something, identify:
39
-
40
- 1. The domain (e.g., React, testing, design, deployment)
41
- 2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
42
- 3. Whether this is a common enough task that a skill likely exists
43
-
44
- ### Step 2: Search for Skills
45
-
46
- Run the find command with a relevant query:
47
-
48
- ```bash
49
- npx skills find [query]
50
- ```
51
-
52
- For example:
53
-
54
- - User asks "how do I make my React app faster?" → `npx skills find react performance`
55
- - User asks "can you help me with PR reviews?" → `npx skills find pr review`
56
- - User asks "I need to create a changelog" → `npx skills find changelog`
57
-
58
- The command will return results like:
59
-
60
- ```
61
- Install with npx skills add <owner/repo@skill>
62
-
63
- vercel-labs/agent-skills@vercel-react-best-practices
64
- └ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
65
- ```
66
-
67
- ### Step 3: Present Options to the User
68
-
69
- When you find relevant skills, present them to the user with:
70
-
71
- 1. The skill name and what it does
72
- 2. The install command they can run
73
- 3. A link to learn more at skills.sh
74
-
75
- Example response:
76
-
77
- ```
78
- I found a skill that might help! The "vercel-react-best-practices" skill provides
79
- React and Next.js performance optimization guidelines from Vercel Engineering.
80
-
81
- To install it:
82
- npx skills add vercel-labs/agent-skills@vercel-react-best-practices
83
-
84
- Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
85
- ```
86
-
87
- ### Step 4: Offer to Install
88
-
89
- If the user wants to proceed, you can install the skill for them:
90
-
91
- ```bash
92
- npx skills add <owner/repo@skill> -g -y
93
- ```
94
-
95
- The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
96
-
97
- ## Common Skill Categories
98
-
99
- When searching, consider these common categories:
100
-
101
- | Category | Example Queries |
102
- | --------------- | ---------------------------------------- |
103
- | Web Development | react, nextjs, typescript, css, tailwind |
104
- | Testing | testing, jest, playwright, e2e |
105
- | DevOps | deploy, docker, kubernetes, ci-cd |
106
- | Documentation | docs, readme, changelog, api-docs |
107
- | Code Quality | review, lint, refactor, best-practices |
108
- | Design | ui, ux, design-system, accessibility |
109
- | Productivity | workflow, automation, git |
110
-
111
- ## Tips for Effective Searches
112
-
113
- 1. **Use specific keywords**: "react testing" is better than just "testing"
114
- 2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
115
- 3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
116
-
117
- ## When No Skills Are Found
118
-
119
- If no relevant skills exist:
120
-
121
- 1. Acknowledge that no existing skill was found
122
- 2. Offer to help with the task directly using your general capabilities
123
- 3. Suggest the user could create their own skill with `npx skills init`
124
-
125
- Example:
126
-
127
- ```
128
- I searched for skills related to "xyz" but didn't find any matches.
129
- I can still help you with this task directly! Would you like me to proceed?
130
-
131
- If this is something you do often, you could create your own skill:
132
- npx skills init my-xyz-skill
133
- ```
@@ -1,120 +0,0 @@
1
- # Humanizer
2
-
3
- A Claude Code skill that removes signs of AI-generated writing from text, making it sound more natural and human.
4
-
5
- ## Installation
6
-
7
- ### Recommended (clone directly into Claude Code skills directory)
8
-
9
- ```bash
10
- mkdir -p ~/.claude/skills
11
- git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
12
- ```
13
-
14
- ### Manual install/update (only the skill file)
15
-
16
- If you already have this repo cloned (or you downloaded `SKILL.md`), copy the skill file into Claude Code’s skills directory:
17
-
18
- ```bash
19
- mkdir -p ~/.claude/skills/humanizer
20
- cp SKILL.md ~/.claude/skills/humanizer/
21
- ```
22
-
23
- ## Usage
24
-
25
- In Claude Code, invoke the skill:
26
-
27
- ```
28
- /humanizer
29
-
30
- [paste your text here]
31
- ```
32
-
33
- Or ask Claude to humanize text directly:
34
-
35
- ```
36
- Please humanize this text: [your text]
37
- ```
38
-
39
- ## Overview
40
-
41
- Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) guide, maintained by WikiProject AI Cleanup. This comprehensive guide comes from observations of thousands of instances of AI-generated text.
42
-
43
- ### Key Insight from Wikipedia
44
-
45
- > "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."
46
-
47
- ## 24 Patterns Detected (with Before/After Examples)
48
-
49
- ### Content Patterns
50
-
51
- | # | Pattern | Before | After |
52
- |---|---------|--------|-------|
53
- | 1 | **Significance inflation** | "marking a pivotal moment in the evolution of..." | "was established in 1989 to collect regional statistics" |
54
- | 2 | **Notability name-dropping** | "cited in NYT, BBC, FT, and The Hindu" | "In a 2024 NYT interview, she argued..." |
55
- | 3 | **Superficial -ing analyses** | "symbolizing... reflecting... showcasing..." | Remove or expand with actual sources |
56
- | 4 | **Promotional language** | "nestled within the breathtaking region" | "is a town in the Gonder region" |
57
- | 5 | **Vague attributions** | "Experts believe it plays a crucial role" | "according to a 2019 survey by..." |
58
- | 6 | **Formulaic challenges** | "Despite challenges... continues to thrive" | Specific facts about actual challenges |
59
-
60
- ### Language Patterns
61
-
62
- | # | Pattern | Before | After |
63
- |---|---------|--------|-------|
64
- | 7 | **AI vocabulary** | "Additionally... testament... landscape... showcasing" | "also... remain common" |
65
- | 8 | **Copula avoidance** | "serves as... features... boasts" | "is... has" |
66
- | 9 | **Negative parallelisms** | "It's not just X, it's Y" | State the point directly |
67
- | 10 | **Rule of three** | "innovation, inspiration, and insights" | Use natural number of items |
68
- | 11 | **Synonym cycling** | "protagonist... main character... central figure... hero" | "protagonist" (repeat when clearest) |
69
- | 12 | **False ranges** | "from the Big Bang to dark matter" | List topics directly |
70
-
71
- ### Style Patterns
72
-
73
- | # | Pattern | Before | After |
74
- |---|---------|--------|-------|
75
- | 13 | **Em dash overuse** | "institutions—not the people—yet this continues—" | Use commas or periods |
76
- | 14 | **Boldface overuse** | "**OKRs**, **KPIs**, **BMC**" | "OKRs, KPIs, BMC" |
77
- | 15 | **Inline-header lists** | "**Performance:** Performance improved" | Convert to prose |
78
- | 16 | **Title Case Headings** | "Strategic Negotiations And Partnerships" | "Strategic negotiations and partnerships" |
79
- | 17 | **Emojis** | "🚀 Launch Phase: 💡 Key Insight:" | Remove emojis |
80
- | 18 | **Curly quotes** | `said “the project”` | `said "the project"` |
81
-
82
- ### Communication Patterns
83
-
84
- | # | Pattern | Before | After |
85
- |---|---------|--------|-------|
86
- | 19 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
87
- | 20 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
88
- | 21 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
89
-
90
- ### Filler and Hedging
91
-
92
- | # | Pattern | Before | After |
93
- |---|---------|--------|-------|
94
- | 22 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
95
- | 23 | **Excessive hedging** | "could potentially possibly" | "may" |
96
- | 24 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
97
-
98
- ## Full Example
99
-
100
- **Before (AI-sounding):**
101
- > The new software update serves as a testament to the company's commitment to innovation. Moreover, it provides a seamless, intuitive, and powerful user experience—ensuring that users can accomplish their goals efficiently. It's not just an update, it's a revolution in how we think about productivity. Industry experts believe this will have a lasting impact on the entire sector, highlighting the company's pivotal role in the evolving technological landscape.
102
-
103
- **After (Humanized):**
104
- > The software update adds batch processing, keyboard shortcuts, and offline mode. Early feedback from beta testers has been positive, with most reporting faster task completion.
105
-
106
- ## References
107
-
108
- - [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) - Primary source
109
- - [WikiProject AI Cleanup](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_AI_Cleanup) - Maintaining organization
110
-
111
- ## Version History
112
-
113
- - **2.1.1** - Fixed pattern #18 example (curly quotes vs straight quotes)
114
- - **2.1.0** - Added before/after examples for all 24 patterns
115
- - **2.0.0** - Complete rewrite based on raw Wikipedia article content
116
- - **1.0.0** - Initial release
117
-
118
- ## License
119
-
120
- MIT