← Back to Skills Marketplace
earthwalking

Academic Writing Assistant

by Roma · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
986
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install academic-writing-assistant
Description
Academic writing assistance skill for paragraph writing, language polishing, grammar checking, academic style optimization, and citation format checking.
README (SKILL.md)

Academic Writing

Overview

学术写作辅助技能,提供论文段落写作、语言润色、语法检查、学术风格优化、引用格式检查等功能。

Capabilities

1. 段落写作

功能:

  • 主题句生成
  • 论证展开
  • 过渡句写作
  • 结论句写作

使用示例:

python academic_writing.py --action write_paragraph --topic "AI psychology" --style APA

2. 语言润色

功能:

  • 语法检查
  • 句式优化
  • 词汇升级
  • 学术风格优化

使用示例:

python academic_writing.py --action polish --input draft.md --output polished.md

润色规则:

  • 避免口语化表达
  • 避免第一人称(除非必要)
  • 使用学术术语
  • 保持句子简洁(15-30 词)
  • 段落长度适中(100-250 词)

3. 格式检查

功能:

  • 引用格式检查
  • 段落格式检查
  • 图表格式检查
  • 参考文献格式检查

支持格式:

格式 学科 版本
APA 心理学、教育学 7th
AMA 医学 11th
Vancouver 生物医学 -
IEEE 工程、计算机 -
Chicago 人文社科 17th

4. 引用管理

功能:

  • 文内引用格式化
  • 参考文献列表生成
  • 引用完整性检查
  • DOI 验证

使用示例:

python academic_writing.py --action format_citations --input paper.md --style APA

Writing Styles

APA 第 7 版(心理学)

文内引用:

  • 单作者:(Smith, 2025)
  • 双作者:(Smith & Jones, 2025)
  • 三作者及以上:(Smith et al., 2025)

参考文献格式:

Author, A. A. (Year). Title of article. Title of Journal, Volume(Issue), Pages. DOI

示例:

Smith, J. (2025). AI in psychology. Journal of Psychology, 10(2), 100-120. https://doi.org/10.1000/jp.2025.001

AMA 第 11 版(医学)

文内引用:

  • 上标数字:研究结果表明¹

参考文献格式:

Author AA. Title of article. Journal. Year;Volume(Issue):Pages. DOI

示例:

Smith J. AI in psychology. J Psychol. 2025;10(2):100-120. doi:10.1000/jp.2025.001

IEEE(工程)

文内引用:

  • 方括号数字:研究结果表明 [1]

参考文献格式:

[N] Author AA. Title of article. Journal. Year;Volume(Issue):Pages.

示例:

[1] Smith J. AI in psychology. J Psychol. 2025;10(2):100-120.

Usage

基本使用

# 段落写作
python academic_writing.py --action write --topic "主观幸福感" --style APA

# 语言润色
python academic_writing.py --action polish --input draft.md --output polished.md

# 格式检查
python academic_writing.py --action check --input paper.md --style APA

# 引用格式化
python academic_writing.py --action format_citations --input paper.md --style APA

高级使用

# 批量润色
python academic_writing.py --action polish --input-dir drafts/ --output-dir polished/

# 格式检查报告
python academic_writing.py --action check --input paper.md --style APA --report report.md

# 引用完整性检查
python academic_writing.py --action check_citations --input paper.md

Quality Checks

语法检查

检查项目:

  • 主谓一致
  • 时态一致
  • 冠词使用
  • 介词使用
  • 句子完整性

常见错误:

  • ❌ The data shows... → ✅ The data show...
  • ❌ In this paper, we studied... → ✅ In this paper, we study...

风格检查

检查项目:

  • 学术语气
  • 避免口语化
  • 避免第一人称(除非必要)
  • 被动语态使用
  • 术语准确性

改进示例:

  • ❌ We think that... → ✅ It is suggested that...
  • ❌ This is a big problem → ✅ This is a significant issue

清晰度检查

检查项目:

  • 句子长度(15-30 词)
  • 段落长度(100-250 词)
  • 逻辑连贯性
  • 过渡词使用
  • 重复内容

改进示例:

  • ❌ 长句(50+ 词)→ ✅ 拆分为 2-3 个短句
  • ❌ 缺少过渡 → ✅ 添加 However, Therefore, Moreover 等

引用检查

检查项目:

  • 引用格式正确
  • 所有引用在参考文献列表中
  • 参考文献列表完整
  • DOI 包含
  • 引用时效性(近 5 年为主)

Output Format

润色报告

# 润色报告

**输入文件**: draft.md
**输出文件**: polished.md
**润色时间**: 2026-03-14 13:15

## 修改统计

| 类型 | 数量 |
|------|------|
| 语法修改 | 5 |
| 句式优化 | 8 |
| 词汇升级 | 12 |
| 格式调整 | 3 |

## 主要修改

### 第 1 段
**原文**: We think that AI is very useful in psychology research.
**修改**: It is suggested that AI demonstrates significant utility in psychological research.
**原因**: 学术风格优化,避免第一人称

### 第 2 段
**原文**: This is a big problem.
**修改**: This represents a significant challenge.
**原因**: 词汇升级

## 格式检查

- [x] 引用格式正确(APA 7th)
- [x] 段落格式正确
- [x] 参考文献列表完整
- [ ] 部分 DOI 缺失(需补充)

Best Practices

写作建议

  1. 段落结构

    • 主题句开头
    • 3-5 个论证句
    • 结论句结尾
  2. 句子长度

    • 避免过长(>40 词)
    • 避免过短(\x3C10 词)
    • 保持变化
  3. 引用规范

    • 直接引用加页码
    • 间接引用要准确
    • 避免过度引用
  4. 学术风格

    • 客观陈述
    • 避免主观判断
    • 使用谨慎语言(may, might, suggest)

避免错误

  1. 语法错误

    • ❌ 主谓不一致
    • ❌ 时态混乱
    • ❌ 句子片段
  2. 风格问题

    • ❌ 口语化表达
    • ❌ 过度使用第一人称
    • ❌ 情绪化语言
  3. 引用问题

    • ❌ 格式不一致
    • ❌ 引用缺失
    • ❌ 过度自引

Integration

与 scientific-writing 配合

scientific-writing: 负责整体结构和内容生成
academic-writing: 负责语言润色和格式检查

与 citation-management 配合

citation-management: 负责文献搜索和引用生成
academic-writing: 负责引用格式化和完整性检查

References


Examples

示例 1: 引言段落润色

输入:

We studied how AI can help psychology research. We found that AI is very useful.

输出:

This study investigated the potential applications of artificial intelligence in psychological research. The findings suggest that AI demonstrates significant utility in enhancing research efficiency and quality.

示例 2: 引用格式化

输入:

Smith 2025 said AI is useful in psychology.

输出 (APA):

Smith (2025) suggested that AI demonstrates utility in psychological research.

参考文献:

Smith, J. (2025). AI in psychology. Journal of Psychology, 10(2), 100-120. https://doi.org/10.1000/jp.2025.001

技能版本: v1.0.0
创建时间: 2026-03-14
维护者: academic-assistant
下次更新: 功能改进时


学术写作,从规范开始!📝✨

Usage Guidance
This is an instruction-only skill: it contains detailed guidance and CLI examples but no code or installer. Before installing or relying on it, note: (1) the examples call a local python script (academic_writing.py) that is not included — the skill will not provide that executable for you; (2) some features (e.g., DOI validation) likely require network access if implemented, but no endpoints or credentials are declared; (3) because no code is bundled, there is nothing to run by default — if you want a runnable tool, obtain an implementation from a trusted source or the maintainer; (4) the skill does not request secrets or special privileges, so it is internally coherent, but verify any external scripts or services you connect to when implementing these instructions.
Capability Analysis
Type: OpenClaw Skill Name: academic-writing-assistant Version: 1.0.0 The skill bundle describes an academic writing assistant designed for paragraph generation, language polishing, and citation formatting. While the documentation (SKILL.md) and configuration (openclaw.skill.json) reference a Python script (academic_writing.py) that is not included in the provided files, the instructions themselves are strictly focused on academic tasks and contain no evidence of malicious intent, prompt injection, or unauthorized data access.
Capability Assessment
Purpose & Capability
The name, description, openclaw.skill.json capabilities, and SKILL.md are consistent: paragraph writing, polishing, style and citation checks are all described and justified by the content.
Instruction Scope
SKILL.md contains detailed runtime examples that call a python script (python academic_writing.py ...) and references local input/output files and batch directories. However, no code is included with the skill, so those examples are illustrative only — the skill itself provides instructions rather than an executable. There are mentions of DOI validation which implies potential network lookups, but no explicit external endpoints are specified.
Install Mechanism
No install spec is present (instruction-only). This minimizes on-disk changes and third-party downloads. Nothing is written to disk by an installer within the package.
Credentials
The skill requests no environment variables, no credentials, and no config paths. That matches the documented functionality and is proportionate to an instruction-only writing assistant.
Persistence & Privilege
The skill does not request always:true and uses default invocation settings. It does not modify other skills or system configuration in the provided files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install academic-writing-assistant
  3. After installation, invoke the skill by name or use /academic-writing-assistant
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Complete academic writing assistance with paragraph writing, polishing, format checking, and citation management. Supports APA/AMA/Vancouver/IEEE/Chicago styles.
Metadata
Slug academic-writing-assistant
Version 1.0.0
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is Academic Writing Assistant?

Academic writing assistance skill for paragraph writing, language polishing, grammar checking, academic style optimization, and citation format checking. It is an AI Agent Skill for Claude Code / OpenClaw, with 986 downloads so far.

How do I install Academic Writing Assistant?

Run "/install academic-writing-assistant" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Academic Writing Assistant free?

Yes, Academic Writing Assistant is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Academic Writing Assistant support?

Academic Writing Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Academic Writing Assistant?

It is built and maintained by Roma (@earthwalking); the current version is v1.0.0.

💬 Comments